--- title: "POST /api/v1/process_multi" method: POST path: "/api/v1/process_multi" tags: ["OCR processing"] --- # POST /api/v1/process_multi `POST /api/v1/process_multi` Procesa múltiples alfabetos mediante OCR ## Request body - ProcessBody — Cuerpo para el procesamiento OCR - `type` 'id_card' | 'passport' | 'driver_license' | 'foreign_card' | 'invoice' | 'pdf' — Es necesario especificar el tipo de documento que se desea procesar, ya que nuestro servicio puede gestionar diferentes tipos de documentos. - `model` string — Este parámetro especifica el ID del documento que se va a procesar. - `files` string[] — Array de imágenes en formato de buffer en bruto codificadas en base64 RFC4648. - `isCropped` boolean — Si la `image` ya está recortada y alineada, el servicio puede evitar realizar estas operaciones. Solo aplica a documentos `invoice`. - `forceDetection` boolean — Si el documento `invoice` no tiene la relación de aspecto correcta, el servicio puede realizar una operación para corregirla y mejorar la detección del documento. Solo aplica a documentos `invoice`. - `retrieveImages` boolean — El servicio devolverá la imagen recortada en base64 en el resultado final. ## Response `200` El resultado del procesamiento OCR - ProcessResultUniversal — Resultado en formato de respuesta universal de un procesamiento de imagen (soporte multialfabeto). - `version` integer, required — Versión del esquema JSON UR de OCR. - `type` string, required — Tipo de documento. - `model` string, required — Modelo del documento. - `ocr` object, required — Diccionario de campos OCR procesados por widgets (claves sin estructura Side/Source/FieldName). - `images` URImage[] — Array que contiene las imágenes extraídas del documento. - `type` 'portrait' | 'ghost' | 'signature' | 'fullFrame' | 'document' | 'fingerprint', required — Tipo de imagen extraída. - `side` integer — Lado del documento (0=Anverso, 1=Reverso). - `source` 'viz' | 'encoded' | 'nfc' | 'mrz', required — Tipo de origen de los datos extraídos. - `content` URImageContent — Contenido de una imagen en formato base64. - `data` string, required — Datos de la imagen codificados en base64 RFC4648. - `length` integer, required — Longitud de los datos de la imagen. - `mime_type` string — Tipo MIME de la imagen. - `region` URRegion — Coordenadas de la región que definen la ubicación de los datos extraídos en la imagen. - `top_left` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `top_right` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `bottom_left` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `bottom_right` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `viz` URViz[], required — Datos extraídos mediante la fuente ML/VIZ. - `field` string, required — Nombre del campo. - `value` string, required — Valor extraído. - `side` integer, required — Lado del documento (0=Anverso, 1=Reverso). - `confidence` number — Puntuación de confianza. - `alphabet` string — Alfabeto utilizado en el campo. - `region` URRegion — Coordenadas de la región que definen la ubicación de los datos extraídos en la imagen. - `top_left` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `top_right` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `bottom_left` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `bottom_right` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `mrz` URMRZ[] — Datos extraídos de la MRZ (Machine Readable Zone). - `side` integer, required — Lado del documento (0=Anverso, 1=Reverso). - `confidence` number — Puntuación de confianza. - `raw` string, required — Texto MRZ en bruto (equivalente al campo MrzText). - `fields` object, required — Diccionario de campos MRZ analizados. - `region` URRegion — Coordenadas de la región que definen la ubicación de los datos extraídos en la imagen. - `top_left` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `top_right` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `bottom_left` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `bottom_right` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `encoded` UREncoded[] — Datos extraídos de QR, código de barras o PDF417. - `fields` object, required — Diccionario de campos analizados a partir de los datos codificados. - `type` 'qr' | 'barcode' | 'pdf', required — Tipo de dato codificado. - `side` integer, required — Lado del documento (0=Anverso, 1=Reverso). - `raw` string, required — Cadena decodificada en bruto (QrData, BarcodeData o PdfData). - `rawBinary` string, required — Datos binarios originales extraídos de la imagen codificada, en base64. - `region` URRegion — Coordenadas de la región que definen la ubicación de los datos extraídos en la imagen. - `top_left` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `top_right` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `bottom_left` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `bottom_right` URCoordinates, required — Coordenadas X,Y en la imagen. - `x` number, required — Coordenada X. - `y` number, required — Coordenada Y. - `nfc` URNFC[] — Datos extraídos mediante NFC. - `field` string, required — Nombre del campo NFC. - `value` string, required — Valor extraído mediante NFC. - `alphabet` string — Alfabeto utilizado en el campo. - `checks` URChecks, required — Comprobaciones de validación realizadas sobre los datos OCR. - `field_inconsistency` FieldInconsistency[] — Lista de inconsistencias de campo encontradas. - `field` string, required — Nombre del campo con inconsistencia. - `values` string[] — Diferentes valores encontrados para el mismo campo. - `distance` integer, required — Métrica de distancia de la inconsistencia. ## Other responses - `400` — Llegan parámetros incorrectos en la petición. - `500` — Se ha producido un error en la llamada al backend de OCR-SDK. --- [API](https://skmtc.net/facephi/apis/selphid-sdk-rest-api.md) · [All operations](https://skmtc.net/facephi/apis/selphid-sdk-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/facephi/selphid-sdk-rest-api/revisions/acc985032f98/schema)