Outils de documentation et de gestion des fichiers
OmniDoc propose des outils de fichiers synchrones et des opérations documentaires asynchrones traçables. Appelez d’abord les points de terminaison de la fonctionnalité ; n’intégrez pas en dur les formats ou limites pris en charge dans le client.
Découverte des capacités
Section intitulée « Découverte des capacités »GET /api/v1/document-operations/capabilitiesGET /api/v1/artifacts/convert/capabilitiesCes éléments renvoient les opérations actuellement ouvertes, leurs formats d’entrée, ainsi que leurs limites de facturation et techniques. Les capacités répertoriées sous unavailable ne peuvent pas être créées.
Opérations documentaires asynchrones
Section intitulée « Opérations documentaires asynchrones »POST /api/v1/document-operationsIdempotency-Key: unique-request-id{ "document_id": "4q8mx2q9z1k7p6ra", "kind": "visual_extract"}Cet endpoint nécessite un Idempotency-Key. kind comprend actuellement :
extract: extraction structurée, gratuite.pdf_to_html: de PDF à en ligne HTML, gratuit.visual_extract: extraction structurée visuelle, facturée à la page (1 crédit par page). Avant le démarrage, le nombre de pages pouvant être traitées est déterminé par le solde (au maximum 20 pages) ; si le solde ne couvre pas une page, le code402est renvoyé. À l’issue du traitement, seules les pages effectivement traitées sont facturées, ce qui peut entraîner un solde négatif.
Interroger et annuler :
GET /api/v1/document-operations/{operation_id}GET /api/v1/document-operations?limit=25POST /api/v1/document-operations/{operation_id}/cancelUne fois terminée, la réponse output_document_id peut être enregistrée dans la bibliothèque de fichiers ou affectée à une autre tâche, et credit_operation_id fournit le relevé de règlement.
Outils PDF
Section intitulée « Outils PDF »POST /api/v1/file-tools/pdf/mergePOST /api/v1/file-tools/pdf/splitPOST /api/v1/file-tools/pdf/compressExemple de fusion :
{"document_ids":["4q8mx2q9z1k7p6ra","b6t1n8c3v9m2x5ka"]}Exemple de fractionnement :
{"document_id":"4q8mx2q9z1k7p6ra","ranges":["1-3","5","8-10"]}Outils d’image
Section intitulée « Outils d’image »POST /api/v1/file-tools/image/convertPOST /api/v1/file-tools/image/compress{ "document_id": "4q8mx2q9z1k7p6ra", "target_format": "webp", "quality": 85}Les outils n’acceptent que les documents dont le compte actuel est propriétaire et dont le type correspond. Transmettez les réponses binaires en flux continu, et extrayez le nom et le type du fichier des en-têtes de réponse.