Protéger les documents
Importez des fichiers texte, PDF ou DOCX, suivez le traitement et récupérez les artefacts protégés.
Flux d’un traitement de document
- Envoyez les octets bruts d’un texte UTF-8, PDF ou DOCX à
POST /v1/documents/jobs. - Conservez l’identifiant de traitement renvoyé et interrogez
GET /v1/documents/jobs/{id}. - Lorsque le traitement réussit, récupérez les artefacts texte, PDF et, le cas échéant, la table de correspondance.
- Supprimez les données temporaires du traitement ou laissez-les expirer une fois le résultat nécessaire enregistré par votre application.
Le type de contenu est déterminant
Envoyez directement les octets du fichier avec text/plain, application/pdfou le type de média DOCX. La taille maximale est de 10 Mo.
Envoyer un fichier
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
Suivre et télécharger les artefacts
curl "https://api.shinrai.innovius.io/v1/documents/jobs/$JOB_ID" \
-H "Authorization: Bearer $SHINRAI_API_KEY"Utilisez les URL d’artefacts renvoyées par la réponse d’état. L’accès au traitement et aux artefacts est limité au compte qui l’a créé.
Gérer les échecs en toute sécurité
Ne transmettez pas le fichier d’origine si la protection échoue. Traitez 415 comme un type de média non pris en charge, 422 comme un contenu de document non valide et 503 comme une indisponibilité temporaire du service de traitement.