--- title: Descripción general description: Guía paso a paso para integrar Human Token — desde la autenticación hasta la obtención de tu primer humanToken. canonical: https://developer.unico.io/es/human-token/api-reference/overview locale: es generated_by: markdown-export --- - [/es/](/es/) - Referencia de API - Descripción general **En esta páginaDescripción general de la API ReferenceTodo lo que necesitas para ir de cero a tu primer humanToken. Human Token tiene tres endpoints. Esta página muestra cómo encajan entre sí para que puedas comenzar a integrar de inmediato. ### URL base​ EntornoURL base**Producción**`https://humantoken.unico.app` Todas las solicitudes requieren el header `x-unico-accesskey`. Consulta [Autenticación](/es/human-token/get-started/authentication) para generar tu clave. ### Flujo de inicio rápido​ ### Paso 1 — Autenticación​ Genera tu `x-unico-accesskey` en el [Human Dashboard](https://dashboard.unico.app) o mediante la [Authentication API](/es/human-token/get-started/authentication). Cada solicitud a continuación utiliza esta clave. ``` x-unico-accesskey: uip_ak.prod.a1b2c3d4.e5f6g7h8.i9j0k1l2 ``` ### Paso 2 — Crear un proceso​ Llama a [Create Process](/es/human-token/api-reference/post-processes) para iniciar la verificación. Elige uno de los dos modelos: ModeloFlowsCómo funciona**API Only**`api+humantoken`, `api+liveness+humantoken`, `api+liveness+humantoken+revalidation`Tu backend envía el selfie como `imageBase64`. El `humanToken` regresa en la misma respuesta.**Human Token Journey**`humantoken`, `humantoken+revalidation`El usuario completa la captura en la plataforma Unico. Obtienes un `token` y un `link` para presentar el journey, luego consultas el resultado con Get Process. **Ejemplo de API Only:** ``` curl -X POST https://humantoken.unico.app/client/v1/process \ -H "x-unico-accesskey: $UNICO_ACCESS_KEY" \ -H "Content-Type: application/json" \ -d '{ "flow": "api+humantoken", "imageBase64": "", "companyBranchId": "" }' ``` **Ejemplo de Human Token Journey:** ``` curl -X POST https://humantoken.unico.app/client/v1/process \ -H "x-unico-accesskey: $UNICO_ACCESS_KEY" \ -H "Content-Type: application/json" \ -d '{ "flow": "humantoken", "callbackUri": "https://yourapp.com/callback", "companyBranchId": "" }' ``` Consulta [Create Process](/es/human-token/api-reference/post-processes) para todos los flows, parámetros y detalles de respuesta. ### Paso 3 — Presentar el journey al usuario (solo flows Journey)​ Para los flows `humantoken` y `humantoken+revalidation`, la respuesta de Create Process incluye: **`token`** — inicializa el [Web SDK](/es/human-token/integrations/web/web-integration/) o la integración nativa **`link`** — URL para redirigir al usuario Elige la integración que se adapte a tu plataforma: PlataformaEnfoque**Web — SDK**Integra el journey en línea con `idpay-b2b-sdk` → [Web Integration](/es/human-token/integrations/web/web-integration/)**Web — Redirect**Redirige al usuario a `link` → [Web Integration](/es/human-token/integrations/web/web-integration/)**Android**Custom Tabs → [Android](/es/human-token/integrations/app/android)**iOS**ASWebAuthenticationSession → [iOS](/es/human-token/integrations/app/ios)**Ionic**Capacitor plugin → [Ionic](/es/human-token/integrations/app/ionic)**React Native**Native module → [React Native](/es/human-token/integrations/app/react-native)**Flutter**Platform Channels → [Flutter](/es/human-token/integrations/app/flutter) Cuando el journey finaliza, el usuario regresa a tu `callbackUri`. Continúa con el Paso 4. Flows API OnlyOmite este paso — el resultado ya está en la respuesta de Create Process. ### Paso 4 — Obtener el resultado (solo flows Journey)​ Llama a [Get Process](/es/human-token/api-reference/get-process) con el `id` del proceso para obtener el resultado: ``` curl https://humantoken.unico.app/client/v1/process/$PROCESS_ID \ -H "x-unico-accesskey: $UNICO_ACCESS_KEY" ``` La respuesta incluye `data.humanToken.value` (flows estándar) o `data.humanTokenMatch` (flows de revalidación). Consulta [Get Process](/es/human-token/api-reference/get-process) para el esquema completo de respuesta y los valores de estado. ### Paso 5 — Usar el humanToken​ El `humanToken` es un identificador estable y opaco (hasta 100 caracteres). La misma persona siempre resuelve al mismo valor. ``` const { humanToken } = process.data;if (!humanToken?.value) { // Inconclusive — retry or reject per your business rules return;}const existing = await db.persons.findByHumanToken(humanToken.value);if (existing) { // Same person seen before — returning user or duplicate} else { // First time — create a new record await db.persons.create({ humanToken: humanToken.value });} ``` advertenciaVerifica siempre que `data.humanToken.value` no esté vacío antes de almacenarlo o compararlo. ### Paso 6 — Obtener el selfie (opcional)​ Llama a [Get Selfie](/es/human-token/api-reference/get-selfie) para descargar la imagen capturada. El selfie está disponible durante **24 horas** después de que finaliza el proceso — después de eso, se elimina permanentemente. ``` curl https://humantoken.unico.app/client/v1/process/$PROCESS_ID/selfie \ -H "x-unico-accesskey: $UNICO_ACCESS_KEY" ``` Consulta [Get Selfie](/es/human-token/api-reference/get-selfie) para detalles de respuesta y códigos de error. ### Endpoints de un vistazo​ MétodoEndpointDescripción`POST``/client/v1/process`[Create Process](/es/human-token/api-reference/post-processes) — iniciar una verificación`GET``/client/v1/process/{processId}`[Get Process](/es/human-token/api-reference/get-process) — obtener el resultado`GET``/client/v1/process/{processId}/selfie`[Get Selfie](/es/human-token/api-reference/get-selfie) — descargar el selfie (24 h) ### Siguientes pasos​ [Create Process](/es/human-token/api-reference/post-processes) — referencia completa de parámetros para los cinco flows [Authentication](/es/human-token/get-started/authentication) — generar y gestionar tus claves de acceso [Build With LLM](/es/human-token/api-reference/build-with-llm) — pega un prompt en tu asistente de IA para generar la integración completa Última actualización el 22 oct 2026**