GET/Face-auth/{authId} - ARGOS Identity

La consulta individual es ahora un endpoint distinto del de la consulta de lista.Lo que antes era GET /v3/faceauth?authId=... es ahora GET /v3/face-auth/{authId}, con authId como parámetro de ruta. Para migrar una integración existente, consulte Referencia común de FaceAuth — Migrar desde la API anterior.

Consulta un único envío de FaceAuth. Puede recuperarse por authId inmediatamente después de crearlo, sin esperar a la indexación.

1. URL base

GET https://rest-api.argosidentity.com/v3/face-auth/{authId}

GET https://kr.rest-api.argosidentity.com/v3/face-auth/{authId}

2. Autenticación

Incluya la clave API del proyecto FaceAuth en el encabezado x-api-key.

x-api-key

x-api-key: {yourAPIKey}

3. Ejemplo de solicitud

curl -X GET "https://rest-api.argosidentity.com/v3/face-auth/{authId}" \
  -H "x-api-key: {yourAPIKey}"

curl -X GET "https://kr.rest-api.argosidentity.com/v3/face-auth/{authId}" \
  -H "x-api-key: {yourAPIKey}"

4. Parámetros de ruta

string

requerido

Clave del envío de FaceAuth. Use el authId de la respuesta de creación de POST o de la respuesta de lista.

5. Respuesta

result.json

{
  "authId": "sampleAuthId1",
  "authStatus": "approved",
  "createTime": "2026-08-11T10:09:14.028Z",
  "submitType": "form",
  "kycSubmissionId": "sampleKycSubmissionId1",
  "deleteTime": null,
  "policy": {
    "faceSimilarity": { "enabled": true, "threshold": 85 },
    "occluded": { "enabled": false, "threshold": null },
    "faceCover": { "enabled": false, "threshold": null },
    "headCover": { "enabled": false, "threshold": null },
    "liveness": { "enabled": false, "threshold": null },
    "activeLiveness": { "enabled": true, "threshold": 75 }
  },
  "result": {
    "faceSimilarity": 100,
    "livenessScore": null,
    "activeLivenessScore": 90.60411071777344,
    "occluded": null,
    "faceCover": null,
    "headCover": null
  },
  "signals": {
    "startButtonClickTime": "2026-08-11T10:08:54.742Z",
    "cameraProcessInfo": [
      {
        "processStartTime": "2026-08-11T10:08:57.300Z",
        "processEndTime": "2026-08-11T10:09:12.278Z",
        "type": "faceAuth-passive",
        "error": null
      }
    ]
  },
  "rejectComment": null,
  "failCode": null
}

5-1. Éxito

Una consulta individual correcta devuelve 200 OK con un objeto FaceAuthSubmission. El objeto aparece tal cual en el nivel superior.

Un elemento de items[] de la consulta de lista y la respuesta de la consulta individual son el mismo objeto. Consultar el mismo authId por cualquiera de las dos rutas devuelve el mismo conjunto de campos.
Los envíos eliminados se devuelven con valor en deleteTime.

5-2. Fallo

Una consulta individual fallida devuelve un código de estado HTTP con un objeto de error.

Un envío que pertenece a otro proyecto FaceAuth devuelve 404, igual que un authId inexistente. La respuesta no permite distinguir ambos casos.

6. Respuestas de error

Los errores que devuelve la aplicación de ARGOS usan el formato { code, message }. El 401 y algunos 403 se bloquean en la capa de autenticación y no siguen ese formato: consulte Referencia común de FaceAuth — Respuestas de error.

Estado HTTP	code	Condición
`400`	`REQUEST_INVALID`	El parámetro de ruta `authId` no es válido
`403`	`AUTH_FORBIDDEN`	La clave API es válida pero no está vinculada a un proyecto FaceAuth
`404`	`FACEAUTH_SUBMISSION_NOT_FOUND`	No se encuentra el `authId` en este proyecto
`503`	`UPSTREAM_UNAVAILABLE`	Un servicio interno necesario para la consulta no está disponible temporalmente. Reintente la misma solicitud en unos instantes
`503`	`UPSTREAM_INVALID_RESPONSE`	El resultado interno de la consulta no puede convertirse al contrato público
`500`	`INTERNAL_UNEXPECTED`	Error inesperado del servidor

Documentos relacionados

Comenzar con FaceAuth

FaceAuth verifica la identidad un paso más comparando la selfie de un usuario aprobado en el proceso de ID check con la selfie capturada durante FaceAuth. Esta página cubre los dos modos de entrega (URL / API), la estructura de query string de la URL de FaceAuth y las definiciones de los parámetros de solicitud.

Resultado de FaceAuth

Después de que se completa la verificación de FaceAuth, el resultado final (aprobado o rechazado) se envía automáticamente a la URL de webhook registrada en el proyecto ID check existente, proporcionando notificaciones en tiempo real.

​1. URL base

​2. Autenticación

​3. Ejemplo de solicitud

​4. Parámetros de ruta

​5. Respuesta

​5-1. Éxito

​5-2. Fallo

​6. Respuestas de error

​Documentos relacionados

Comenzar con FaceAuth

Resultado de FaceAuth

1. URL base

2. Autenticación

3. Ejemplo de solicitud

4. Parámetros de ruta

5. Respuesta

5-1. Éxito

5-2. Fallo

6. Respuestas de error

Documentos relacionados