Encabezados
| Encabezado | Valor |
|---|---|
Content-Type | application/json |
Cuerpo de la solicitud
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
email | string | Sí | Dirección de correo electrónico del patrocinador humano. Debe ser una dirección de correo electrónico válida. |
agent_name | string | Sí | Nombre del agente que crea la clave (de 1 a 100 caracteres). Se muestra en el correo electrónico de verificación. |
accept_terms | boolean | Sí | Debe ser true. Confirma la aceptación de los Términos del servicio. |
Respuesta
| Field | Type | Description |
|---|---|---|
success | boolean | Si la clave se creó |
api_key | string | La API key aprovisionada (empieza con fc-) |
sponsor_status | string | Siempre "pending" al crearse |
credit_limit | number | Máximo de crédito disponible antes de la verificación (50) |
credits_remaining | number | Crédito restante (50 al crearse) |
verification_deadline_at | string | Marca temporal ISO 8601. El patrocinador debe confirmar antes de esta fecha límite (5 días). |
tos_url | string | URL de los Términos del Servicio aceptados |
Ejemplo de solicitud
Ejemplo de respuesta
Respuestas de error
| Status | Error | When |
|---|---|---|
400 | Cuerpo de la solicitud no válido | Faltan campos o hay campos no válidos |
403 | Este correo electrónico ha bloqueado los registros de agente | El patrocinador bloqueó previamente los registros de agente |
403 | La verificación de un registro anterior de agente ha expirado | Un registro anterior expiró; el patrocinador debe iniciar sesión |
409 | Ya se ha enviado una confirmación pendiente de registro de agente | Ya hay una clave pendiente para este correo electrónico |

