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/Face-auth/{authId}

GET https://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

GET/Face-auth/{authId}

curl -X GET "https://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

​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

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