OCR Platform
Admin

URL base API

https://ocr.789.com.mx/v1

Postman

Importa la colección oficial para probar la API sin escribir código.

Descargas

Archivo Enlace
Colección v1 Descargar colección
Entorno local Descargar entorno local
Entorno Railway Descargar entorno Railway

Configuración

  1. Postman → Import → importa la colección y el entorno.
  2. Selecciona el entorno en la esquina superior derecha.
  3. Edita variables:
    • base_url → https://ocr.789.com.mx (sin /v1; la colección ya lo añade)
    • api_key → tu API Key (solicítala al equipo de plataforma)

Scopes requeridos

  • documents:create, documents:read, results:read
  • extractions:create, extractions:read (si pruebas extracción)
  • usage:read (si pruebas consumo)

Flujo de prueba

Paso Request Notas
1 Health → Health Live Sin API Key
2 Documents → Crear documento Campo file tipo File
3 Documents → Detalle documento Repetir hasta completed o partial_success
4 Documents → Resultado OCR format=markdown
5 Extractions → Crear extracción Con document_id guardado
6 Extractions → Resultado extracción JSON extraído

Crear documento en Postman

  1. Body → form-data (no raw JSON).
  2. file → tipo File → selecciona un PDF.
  3. profile → cfdi_invoice (o el perfil que corresponda).
  4. output_formats[] → markdown, json.
  5. Header Idempotency-Key → {{$guid}}.

Documento en queued mucho tiempo

La API encola trabajos en background. Si el documento no avanza, la plataforma lo pasa a failed con document_queue_timeout a los 15 minutos. Si te pasa de forma repetida, contacta al equipo de plataforma con el meta.request_id.