Create a new Face Match Request

POST

/v2/face-match

Initiates a face match process between two provided images. The result, along with metadata, is stored as a request.

Solicitud

Autorización

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Parámetros del Body application/json

Ejemplos

Respuestas

🟢201Creado

application/json

Request created successfully

Body

🟠400Solicitud incorrecta

🔴500Error interno del servidor

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.veriflow.me/v2/face-match' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userImage": "string",
    "refImage": "string",
    "faceMatchScoreDeclineThreshold": 0,
    "rotateImage": true,
    "metadata": null
}'

Ejemplo de Respuesta

{
    "success": true,
    "payload": {
        "request": {
            "id": "string",
            "organizationId": "string",
            "type": "string",
            "status": "string",
            "createdAt": "string",
            "updatedAt": "string",
            "cost": 0,
            "info": {
                "metadata": null,
                "init": {
                    "userImage": "string",
                    "refImage": "string",
                    "faceMatchScoreDeclineThreshold": 0,
                    "rotateImage": true,
                    "metadata": null
                },
                "response": {
                    "status": "string",
                    "score": 0,
                    "sourceImage": "http://example.com",
                    "targetImage": "http://example.com",
                    "warnings": [
                        {
                            "feature": "string",
                            "risk": "string",
                            "additionalData": null,
                            "logType": "string",
                            "shortDescription": "string",
                            "longDescription": "string"
                        }
                    ],
                    "userImage": {
                        "bestAngle": 0,
                        "entities": [
                            {
                                "age": 0,
                                "confidence": 0,
                                "gender": "string",
                                "bbox": [
                                    0
                                ]
                            }
                        ]
                    },
                    "refImage": {
                        "bestAngle": 0,
                        "entities": [
                            {
                                "age": 0,
                                "confidence": 0,
                                "gender": "string",
                                "bbox": [
                                    0
                                ]
                            }
                        ]
                    }
                }
            }
        }
    }
}

Modificado en 2025-12-06 17:47:50

Create a new ID Verification Request

Create a new Age Estimation Request