واجهة API والمطورون
أضف الفوترة الإلكترونية العُمانية إلى نظامك عبر واجهة واحدة ذات إصدارات
أرسل المستندات، واستلم نتائج التحقق، واقرأ حالة دورة حياتها عبر واجهة REST ذات إصدارات، موثقة بمواصفات OpenAPI 3.1، مع مجموعة Postman ودليل بدء سريع لتنجح أول عملية اتصال لك.
- /api/v1/
- OpenAPI 3.1
- مجموعة Postman
ماذا تقدم واجهة Invoice And Tax البرمجية؟
واجهة REST ذات إصدارات ضمن المسار /api/v1/، تتحقق فيها من هويتك بمفاتيح وصول (Bearer) تظهر مرة واحدة ومقيدة بمنشأة أو فرع. وتوصف الواجهة بمواصفات OpenAPI 3.1، وتأتي مع مجموعة Postman ودليل بدء سريع.
النتائج
ما يحصل عليه المطورون
-
واجهة REST ذات إصدارات
مسار /api/v1/ مستقر، فلا يتعطل ربطك عند تطور المنصة.
-
مفاتيح وصول محددة النطاق
تظهر مفاتيح API مرة واحدة عند إنشائها، وتُقيَّد بمنشأة أو فرع.
-
مواصفات OpenAPI 3.1
عقد مقروء آلياً لتوليد العملاء البرمجيين والتحقق من الطلبات.
-
مجموعة Postman ودليل بدء سريع
نفّذ أول اتصال موثق بسرعة، ثم ابنِ على أمثلة تعمل.
آلية العمل
مسار الطلب
يتحقق تطبيقك من هويته بمفتاح API مقيد بالمنشأة، ثم يرسل المستند، ويستلم نتيجة التحقق، ويقرأ حالة دورة حياة المستند. وتمر المستندات المرسلة عبر الواجهة بقواعد التحقق ذات الإصدارات نفسها التي تمر بها بقية المصادر.
- التحقق من الهوية بمفتاح مقيد
- إرسال المستند
- قراءة نتيجة التحقق وحالة دورة الحياة
حسب الدور
ما يعنيه ذلك لكل دور
-
الفريق المالي
أتمتة دون إعادة إدخال
تتدفق الفواتير من نظام ERP أو الفوترة لديك مباشرة إلى التحقق.
-
المحاسب
نتائج متسقة
تخضع مستندات الواجهة للقواعد نفسها، فيرى الفريق المالي معياراً واحداً.
-
تقنية المعلومات
عقد يمكنك البناء عليه
تجعل OpenAPI 3.1 ومجموعة Postman والمفاتيح المقيدة الربط قابلاً للتنبؤ.
أسئلة عن واجهة API
كيف أتحقق من الهوية؟
بمفتاح API من نوع Bearer، يظهر مرة واحدة عند إنشائه ويُقيَّد بمنشأة أو فرع.
هل تتوفر مواصفات للواجهة؟
نعم، مواصفات OpenAPI 3.1، إلى جانب مجموعة Postman ودليل بدء سريع.
هل للواجهة إصدارات؟
نعم. يُقدَّم الإصدار الحالي ضمن المسار /api/v1/.
كيف أحصل على الوصول؟
تواصل معنا بوصف موجز لمشروع الربط، وسنجهّز لك الوصول.