واجهة برمجة تطبيقات واحدة للمحاسبة المستندة إلى المعايير
الفوترة، ودفتر الأستاذ، والتسوية المصرفية، والإقرارات الضريبية كلها عبارة عن واجهة برمجة تطبيقات JSON واحدة. يعمل التطبيق نفسه على نفس نقاط النهاية التي تحصل عليها.
فتح مرجع واجهة برمجة التطبيقات التفاعليكل نقطة نهاية، ومخطط، ومثال تم إنشاؤها من المواصفات الحية.
كيف تعمل
طلبات متوقعةكل عملية هي
POST /v1/{module}/{resource}/{action} مع نص JSON. بمجرد معرفة النمط، تعمل أي وحدة بنفس الطريقة.مفاتيح واجهة برمجة التطبيقات مع نطاقاتالمصادقة باستخدام
Authorization: Bearer. تحدد النطاقات مثل sales:write كل تكامل بالوصول الذي تحتاجه بالفعل.عمليات إعادة محاولة آمنةأضف رأس
Idempotency-Key ولن ينشئ الطلب المُعاد محاولته نسخة مكررة أبداً.خطافات الويباشترك في الأحداث مثل
sale_invoice.paid. يتم توقيع عمليات التسليم بـ HMAC وإعادة محاولتها مع التراجع التدريجي، لذلك لن اضطر أبداً للاستطلاع.حزم تطوير برمجيات (SDK) مزودة بأنواع البياناتعميل TypeScript تم إنشاؤه من مواصفات OpenAPI، مع أنواع طلبات واستجابات لكل نقطة نهاية.
أموال دقيقةتنتقل المبالغ كسلاسل عشرية بدلاً من الأعداد العشرية العائمة، بحيث تتطابق الدفاتر حتى السنت.
اتصالك الأول
curl -X POST https://api.nordlet.com/v1/partners/create \
-H "Authorization: Bearer nl_your_api_key" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: my-first-partner" \
-d '{"name": "UAB Example", "code": "301111222"}'