| Elemento | Cómo funciona |
|---|
| POST /front | Analiza el frente y devuelve el uuid que engancha con el dorso |
|---|
| POST /back | Analiza el dorso y lo cruza con el frente, usando ese uuid como relatedUuid |
|---|
| GET /listTemplates | Los documentos soportados. Con /{templateId}/details, qué campos esperar de cada uno, y con /{templateId}/images, imágenes de muestra anonimizadas |
|---|
| GET /version | Verifica conectividad. Se evalúa el código de estado, no el cuerpo |
|---|
| Autenticación | Cabecera Api-Key. Cada servicio tiene su propia clave, por ambiente |
|---|
| URL base | VU la entrega junto con la clave, según el ambiente |
|---|
| Entrada | info como referencia de negocio e image en base64. En el dorso, además, relatedUuid |
|---|
| Salida | uuid, id (el tipo de documento), front y back con los datos, crossMatchConfidence, code y message |
|---|
PeticiónPOST /back
// Cabecera: Api-Key: <tu clave del servicio>
{
"info": "onboarding-12345",
"image": "<foto del dorso en base64, sin prefijo>",
"relatedUuid": "<el uuid que devolvió POST /front>"
}
{
"info": "onboarding-12345",
"image": "<foto del dorso en base64, sin prefijo>",
"relatedUuid": "<el uuid que devolvió POST /front>"
}
"frontBackTemplateValidation": trueEl dorso corresponde al frente. Revisas la consistencia de los datos y decides."frontBackTemplateValidation": falseEs el dorso de otro documento. No aceptas."message": "Cant get document fields"En el frente: no se pudo leer el documento. Pides otra captura.
La regla de decisiónTu backend
// Frente: aceptar exige las tres condiciones.
const frenteOk =
status === 200 &&
body.message === "Operation end successfully." &&
body.id !== "unknown";
// Dorso: además de lo anterior.
const dorsoOk = body.back.frontBackTemplateValidation === true;
// Y revisas body.crossMatchConfidence antes de dar por buenos los datos.
const frenteOk =
status === 200 &&
body.message === "Operation end successfully." &&
body.id !== "unknown";
const dorsoOk = body.back.frontBackTemplateValidation === true;
Un 200 no significa datos extraídos
Una foto sin documento legible también responde 200, con el mensaje "Cant get document fields" y el tipo de documento en "unknown". Y un dorso que no corresponde al frente responde 200 con "Operation end successfully.". Si decides solo por el código de estado, aceptas documentos ilegibles y documentos armados con caras de dos documentos distintos.