Comenzar con Unit API

• Una llamada devuelve un resultado. No se crea ningún envío (submission).
• Todas las llamadas son síncronas. El resultado llega en la respuesta y no hay webhooks.
• Solo se facturan las llamadas que devuelven un resultado. Las llamadas que terminan en error no se facturan.

​

APIs disponibles

​

Análisis de imagen y texto

​

Consultas a registros oficiales y bancarios

​

Primeros pasos

​

Endpoints

POST https://client-api.argosidentity.com/v1/units/{api}

• {api} es la ruta indicada en la página de cada API. Ejemplo: /v1/units/id-ocr
• Las 14 API están disponibles en todas las regiones.
• La clave solo funciona en la región de su proyecto. Llamar al host de otra región devuelve 401. Consulte la región de su proyecto en Regiones.

​

Autenticación

curl -X POST "https://client-api.argosidentity.com/v1/units/txt-fz-mat" \
  -H "x-api-key: {yourUnitApiKey}" \
  -H "Content-Type: application/json" \
  -d '{"text1": "Hong Gildong", "text2": "Gildong Hong", "referenceId": "order-20261103-0001"}'

curl -X POST "https://kr.client-api.argosidentity.com/v1/units/txt-fz-mat" \
  -H "x-api-key: {yourUnitApiKey}" \
  -H "Content-Type: application/json" \
  -d '{"text1": "Hong Gildong", "text2": "Gildong Hong", "referenceId": "order-20261103-0001"}'

​

Reemisión de la clave

• Si la clave se expone o se sospecha un uso indebido, un Owner o Leader la reemite desde el panel.
• Al reemitir, la clave anterior se revoca de inmediato. Las llamadas con la clave anterior se rechazan con 401 INVALID_API_KEY y no se facturan.
• Quién reemitió la clave y cuándo queda registrado en el historial de claves y en el Registro de eventos.

​

Reglas de solicitud

• Envíe un cuerpo JSON con Content-Type: application/json. Otros tipos se rechazan con 415 UNSUPPORTED_MEDIA_TYPE.
• Los campos que no están en el contrato se rechazan con 400 UNKNOWN_PARAMETER. Así se evita que un error tipográfico se ignore en silencio y se facture con un resultado inesperado.
• Una cadena vacía ("") o null no se considera “no enviado” y se rechaza con 400 INVALID_PARAMETER_FORMAT. Si un campo opcional no tiene valor, omita la clave.
• Las fechas usan el formato YYYY-MM-DD. Ejemplo: 2019-03-14

​

Imágenes

• Envíe las imágenes como cadenas Base64. Un prefijo como data:image/jpeg;base64, es opcional.
• Solo se aceptan JPEG y PNG. Convierta HEIC de iPhone, GIF, BMP y otros formatos a JPEG antes de enviarlos.
• Cada imagen puede ocupar hasta unos 3 MB en tamaño original (4.000.064 caracteres Base64 sin el prefijo). Las imágenes más grandes devuelven 400 PARAMETER_OUT_OF_RANGE. La mayoría de las fotos de documentos tomadas con el móvil se pueden enviar tal cual.

​

referenceId

​

Respuesta común

{
  "txId": "01a17c3a-646f-762e-bb38-fe0cae059282",
  "txCode": "FACE_LIVE_PSV",
  "createdAt": "2026-11-03T07:19:24.015Z",
  "latencyMs": 812,
  "billing": {
    "unit": "response",
    "count": 1,
    "unitPrice": 0.08,
    "credit": 0.08,
    "pricingVersion": "v4.0_KOR"
  },
  "referenceId": "order-20261103-0001",
  "data": {
    "livenessScore": 93
  }
}

​

Cómo leer los veredictos

• MATCH: Coincide con los registros de la fuente.
• MISMATCH: La fuente respondió que no coincide. Se realizó la consulta, por lo que se factura.
• REJECTED: Auténtico, pero ya no es válido (un pasaporte que perdió su validez, o una empresa suspendida o cerrada).

​

Facturación

• Las llamadas que devuelven un resultado se facturan. Una similitud facial baja o un MISMATCH de la fuente también es un resultado, por lo que se factura.
• Las llamadas que terminan en error no se facturan. Esto incluye toda respuesta cuyo estado HTTP no sea 200.
• Las llamadas ejecutadas desde la Prueba de API del panel se facturan igual.
• Los proyectos de prueba (Trial) no se facturan. En su lugar, el número de llamadas al mes está limitado. Uso según el estado del proyecto
• Enviar la misma solicitud dos veces se procesa y se factura como dos llamadas.

​

Precios por API

​

Uso según el estado del proyecto

• El límite de Trial cuenta todas las llamadas, incluidos los errores. Se incluyen las llamadas con error no facturadas y las rechazadas por superar el límite.
• El límite se restablece a las 00:00 UTC del primer día de cada mes.
• Al alcanzar el límite, las llamadas devuelven 429 TRIAL_LIMIT_EXCEEDED y el encabezado Retry-After indica los segundos que faltan para el restablecimiento.

​

Conservación de datos y privacidad

• Los cuerpos de solicitud y respuesta no se almacenan. Guarde el resultado con su txId en su sistema en cuanto reciba la respuesta. No podrá recuperar los resultados desde ARGOS más tarde.
• Los registros de llamadas se conservan 3 años. Incluyen la hora de la llamada, la API, el resultado, el código de error, el tiempo de procesamiento, el count, los créditos, el origen (en vivo o prueba de API), quién la ejecutó y el referenceId.
• Incluso en pruebas, necesita una base legal, como el consentimiento del interesado, para usar información personal real.

​

Próximos pasos