ShinrAIAlojado en STACKIT

Proteger documentos

Sube archivos de texto, PDF o DOCX, sigue el trabajo y recupera los artefactos protegidos.

Flujo de un trabajo de documento

  1. Envía los bytes sin procesar de texto UTF-8, PDF o DOCX a POST /v1/documents/jobs.
  2. Conserva el ID del trabajo devuelto y consulta GET /v1/documents/jobs/{id}.
  3. Cuando el trabajo termine correctamente, recupera los artefactos de texto, PDF y, si se solicitó, el mapa.
  4. Elimina los datos temporales del trabajo o deja que caduquen cuando la aplicación haya guardado el resultado necesario.
El tipo de contenido es importante

Envía directamente los bytes del archivo con text/plain, application/pdfo el tipo multimedia de DOCX. El tamaño máximo es de 10 MB.

Enviar un archivo

curl 'https://api.shinrai.innovius.io/v1/documents/jobs?mode=replace&include_mapping=true' \
  -H "Authorization: Bearer $SHINRAI_API_KEY" \
  -H 'Content-Type: application/pdf' \
  -H 'Idempotency-Key: customer-case-4815' \
  --data-binary @case.pdf

Consultar y descargar artefactos

curl "https://api.shinrai.innovius.io/v1/documents/jobs/$JOB_ID" \
  -H "Authorization: Bearer $SHINRAI_API_KEY"

Usa las URL de artefactos de la respuesta de estado. Solo la cuenta que creó el trabajo puede acceder al trabajo y a sus artefactos.

Gestionar los fallos de forma segura

No reenvíes el archivo original si falla la protección. Trata 415 como un tipo multimedia no compatible, 422 como contenido de documento no válido y 503 como un fallo temporal del procesador.

Probar el ejemplo de documento →