Verificación
Endpoints para verificación de email y teléfono.
La verificación de email y teléfono es obligatoria para acceder a ciertas funcionalidades.
Flujo de Verificación
Solicitar código
Llama a /request_confirmation/ especificando el tipo (email o phone).
Recibir código
El usuario recibe un código de 6 dígitos por SMS o email.
Verificar código
Envía el código al endpoint correspondiente (/verify_email/ o /verify_phone/).
Confirmación
El campo email_verified o phone_verified se actualiza a true.
Solicitar Código de Verificación
Envía un código de verificación al email o teléfono del usuario.
Endpoint
POST /request_confirmation/Headers
Authorization: Bearer [ACCESS_TOKEN]
Content-Type: application/json
x-api-key: [API_KEY]Request
{
"type": "email"
}Respuesta
{
"message": "Verification code sent"
}El código expira en 5 minutos. Si expira, solicita uno nuevo.
Verificar Teléfono
Confirma el número de teléfono del usuario.
Endpoint
POST /verify_phone/Headers
Authorization: Bearer [ACCESS_TOKEN]
Content-Type: application/json
x-api-key: [API_KEY]Request
{
"code": "123456"
}Respuesta
{
"message": "Phone verified successfully"
}El campo phone_verified del perfil se actualiza a true.
Verificar Email
Confirma el correo electrónico del usuario.
Endpoint
POST /verify_email/Headers
Authorization: Bearer [ACCESS_TOKEN]
Content-Type: application/json
x-api-key: [API_KEY]Request
{
"code": "654321"
}Respuesta
{
"message": "Email verified successfully"
}El campo email_verified del perfil se actualiza a true.
Estado de Verificación
Consulta el estado de verificación en el endpoint GET /user/:
{
"phone_verified": true,
"email_verified": false
}Indicadores de Estado
| Estado | Icono | Significado |
|---|---|---|
true | ✅ | Verificado correctamente |
false | ❌ | Pendiente de verificación |
Tip: Verifica ambos (email y teléfono) para desbloquear todas las funcionalidades.
Ejemplo Completo
1. Solicitar código para email
curl -X POST https://dev.backend.colurs.co/request_confirmation/ \
-H "Authorization: Bearer [TOKEN]" \
-H "x-api-key: [API_KEY]" \
-H "Content-Type: application/json" \
-d '{"type": "email"}'2. Usuario recibe email
El usuario recibe un email con el código 123456.
3. Verificar el código
curl -X POST https://dev.backend.colurs.co/verify_email/ \
-H "Authorization: Bearer [TOKEN]" \
-H "x-api-key: [API_KEY]" \
-H "Content-Type: application/json" \
-d '{"code": "123456"}'4. Verificación completa
El campo email_verified ahora es true.