واجهة API للفوترة الإلكترونية للمطورين: أرسل الفواتير واستلم نتيجة الهيئة
اربط نقطة البيع أو نظام تخطيط الموارد أو برنامجك المخصص بواجهة REST صغيرة. أرسل فاتورة، واستلم نتائج التحقق وحالة الهيئة، واطبع رمز QR عند نقطة البيع.
ما تقدمه الواجهة
- إرسال فاتورة بترويسة Idempotency-Key إلزامية، فلا تنشئ إعادة المحاولة نسخة مكررة.
- توقيع فوري (sign=now) واستلام رمز QR لطباعته على الإيصال.
- قراءة فاتورة أو قائمة بحالتها لدى الهيئة.
- مفاتيح API لكل تكامل بصلاحيات قراءة وكتابة وحد معدل لكل مفتاح.
- ويب هوك موقّعة للأحداث الواردة واستدعاءات موقّعة حين تجيب الهيئة.
- وصف OpenAPI قابل للقراءة آليا على /api/v1/openapi.json.
الأمان
- HTTPS فقط؛ تُعرض المفاتيح مرة واحدة وتُخزَّن كبصمة.
- تستخدم توقيعات الويب هوك والاستدعاءات HMAC-SHA256 على الوقت والمحتوى مع نافذة صلاحية قصيرة.
- يجب أن تكون عناوين الاستدعاء عناوين https عامة وهي محمية من الطلبات إلى الشبكات الداخلية.
- الوصول من المتصفحات عبر النطاقات مغلق ما لم تدرج نطاقاتك.
اختبر قبل الإطلاق
استخدم نقطة التجربة الجافة لترى نتيجة التحقق الكاملة لمحتوى دون حفظ أو إرسال، وبيئة الهيئة التجريبية للاختبار الشامل.