Saltar al contenido principal
POST
/
v1
/
textify
/
parser
curl --request POST \
  --url https://textify-api.argosidentity.com/v1/textify/parser \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "country": "mex",
  "image": "base64-encoded-image-data"
}
'
{
  "rawExtractions": {
    "nombre": "LUIS DANIEL",
    "domicilio": "C CAMPO AEREO 24",
    "clave_de_elector": "SLGZL501094H42BH00",
    "fecha_de_nacimiento": "09/09/2001"
  },
  "standardized": {
    "country": "MEX",
    "person": {
      "name": {
        "givenName": "LUIS DANIEL",
        "paternalSurname": "GUZMAN",
        "fullName": "LUIS DANIEL GUZMAN"
      },
      "gender": "male",
      "dateOfBirth": "2001-09-09",
      "nationality": "MEX"
    },
    "document": {
      "type": "voter_id",
      "number": "SLGZL501094H42BH00",
      "issueDate": "2019-01-01",
      "expiryDate": "2030-12-31",
      "issuingAuthority": "INSTITUTO NACIONAL ELECTORAL"
    },
    "address": {
      "street": "C CAMPO AEREO 24",
      "city": "HUAJUAPAN DE LEON",
      "state": "OAX",
      "postalCode": "69007"
    }
  }
}
Textify ID AutoParser API es un servicio de extracción de texto de documentos que procesa documentos de identificación gubernamentales y extrae datos estructurados de imágenes. Soporta documentos de identificación utilizando cuatro plantillas diferentes. Primero, documentos de identificación con plantilla general; cualquier documento de identificación que no sea de los países del segundo tipo. El segundo tipo es de los siguientes países: México (MEX), Filipinas (PHL) y Corea del Sur (KOR).

​
Formatos de imagen soportados

✅ Soportados:
  • JPEG (.jpg, .jpeg)
  • PNG (.png)
❌ No soportados:
  • GIF (.gif)
  • BMP (.bmp)
  • WebP (.webp)
  • TIFF (.tiff, .tif)
  • PDF (.pdf)

​
Tiempo de respuesta

⏱️ Tiempo de respuesta esperado: 20-30 segundos La API procesa imágenes utilizando algoritmos avanzados de OCR y extracción de datos, que requieren un tiempo de procesamiento significativo. Planifique tiempos de espera de al menos 60 segundos en sus aplicaciones cliente.

​
Requisitos de imagen

​
Tamaño de archivo

  • Recomendado: Menos de 10MB
  • Máximo: 50MB

​
Calidad de imagen

  • Resolución: Se recomienda un mínimo de 300 DPI
  • Formato: Las imágenes de alto contraste y bien iluminadas funcionan mejor
  • Orientación: El documento debe estar correctamente orientado (no rotado)

​
Codificación Base64

Las imágenes deben convertirse a formato Base64 antes de enviarlas. La cadena Base64 debe contener solo los datos de imagen codificados sin prefijos de URI de datos (por ejemplo, elimine data:image/jpeg;base64, si está presente).

​
Manejo de errores

​
Escenarios de error comunes

Status CodeError TypeDescripción
400Bad RequestEl cuerpo de la solicitud debe contener un campo image con datos base64.
401UnauthorizedAcceso denegado: la clave API no está disponible.
413Payload Too LargeEl archivo de imagen es demasiado grande
415Unsupported Media TypeFormato de archivo no soportado. Solo se soportan archivos JPEG y PNG.
429Too Many RequestsSe excedió el límite de solicitudes
500Internal Server ErrorError del servidor OpenAI/Gemma API

Autorizaciones

​
x-api-key
string
header
requerido

Cuerpo

application/json
​
image
file
requerido

Base64 encoded image data. Only JPEG (.jpg, .jpeg) and PNG (.png) are supported.

​
country
enum<string>

Country code: "mex" (Mexico) or "phl" (Philippines) or "kor" (South Korea). Optional field that provides more concrete results when used.

Opciones disponibles:
mex,
phl,
kor

Respuesta

Successful parsing

​
rawExtractions
object

Raw OCR results based on the fields depicted on the ID document. Output varies by document type and country.

​
standardized
object

Standardized data structure. Output format depends on country template used.