أدوات المستندات والملفات
يوفر OmniDoc أدوات ملفات متزامنة وعمليات وثائق غير متزامنة قابلة للتتبع. اتصل بEndpoints الخاصة بالقدرات أولاً؛ ولا تقم بترميز الصيغ المدعومة أو القيود بشكل ثابت في العميل.
اكتشاف القدرات
Section titled “اكتشاف القدرات”GET /api/v1/document-operations/capabilitiesGET /api/v1/artifacts/convert/capabilitiesتُرجع هذه العناصر العمليات المفتوحة حاليًا، وتنسيقات الإدخال الخاصة بها، والحدود المتعلقة بالفوترة والجوانب التقنية. ولا يمكن إنشاء القدرات المدرجة ضمن unavailable.
عمليات المستندات غير المتزامنة
Section titled “عمليات المستندات غير المتزامنة”POST /api/v1/document-operationsIdempotency-Key: unique-request-id{ "document_id": "4q8mx2q9z1k7p6ra", "kind": "visual_extract"}يتطلب هذا النهاية Idempotency-Key. يشمل kind حاليًا:
extract: استخراج منظم، مجاني.pdf_to_html: من PDF إلى HTML عبر الإنترنت، مجانًا.visual_extract: استخراج منظم بصريًا، يُحتسَب تكلفة كل صفحة (رصيد واحد لكل صفحة). قبل البدء، يتم تحديد عدد الصفحات التي يمكن معالجتها بناءً على الرصيد المتاح (بحد أقصى 20 صفحة)؛ وإذا كان الرصيد لا يكفي لمعالجة صفحة واحدة، يتم إرجاع402. عند الانتهاء، تُحتسَب تكلفة الصفحات الفعلية التي تمت معالجتها، وقد يصبح الرصيد سالبًا.
الاستعلام والإلغاء:
GET /api/v1/document-operations/{operation_id}GET /api/v1/document-operations?limit=25POST /api/v1/document-operations/{operation_id}/cancelعند اكتمال العملية، يمكن إدراج output_document_id الخاص بالاستجابة في مكتبة الملفات أو في مهمة أخرى، بينما يوفر credit_operation_id سجل التسوية.
أدوات PDF
Section titled “أدوات PDF”POST /api/v1/file-tools/pdf/mergePOST /api/v1/file-tools/pdf/splitPOST /api/v1/file-tools/pdf/compressمثال الدمج:
{"document_ids":["4q8mx2q9z1k7p6ra","b6t1n8c3v9m2x5ka"]}مثال على التقسيم:
{"document_id":"4q8mx2q9z1k7p6ra","ranges":["1-3","5","8-10"]}أدوات الصور
Section titled “أدوات الصور”POST /api/v1/file-tools/image/convertPOST /api/v1/file-tools/image/compress{ "document_id": "4q8mx2q9z1k7p6ra", "target_format": "webp", "quality": 85}تقبل الأدوات فقط المستندات التي يمتلكها الحساب الحالي والتي يتطابق نوعها مع المتطلبات. قم بتدفق الاستجابات الثنائية، واحصل على اسم الملف ونوعه من رؤوس الاستجابة.