المطورون
نظام ربط مبني على الواجهة البرمجية أولًا: كل ميزة متاحة عبر الواجهة العامة، وتطبيق الويب نفسه يستخدم الواجهة ذاتها.
واجهة REST العامة
- تُقدَّم على api.rabt.systems، بإصدار في المسار (/v1/…)، وتصفها مواصفة OpenAPI مولّدة من الشيفرة.
- حِزم برمجية مُنمَّطة مولّدة من المواصفة، بدءًا بـ TypeScript.
- JSON بأوقات ISO 8601 بتوقيت UTC، وترقيم صفحات بالمؤشر، ومفتاح Idempotency-Key لكل عملية إنشاء أو عملية مدفوعة.
- الأخطاء بصيغة problem details مع رمز الخطأ والرقم المرجعي، وحدود الطلبات لكل مفتاح API ولكل كيان في ترويسات الرد.
المصادقة
- مفاتيح API لكل كيان بنطاقات (قراءة أو كتابة لكل وحدة)، تُخزَّن مجزأة وتظهر مرة واحدة.
- OAuth 2.1 مع PKCE لتطبيقات الأطراف الأخرى، بشاشة موافقة محددة النطاقات.
- كل طلب يخضع لفحوص الصلاحيات وعزل المنشآت وسجل التدقيق نفسها في تطبيق الويب.
خادم MCP
- خادم Model Context Protocol بعيد على api.rabt.systems/mcp عبر Streamable HTTP.
- OAuth بالنطاقات نفسها في الواجهة البرمجية، ويمكن للتكاملات من خادم إلى خادم استخدام مفتاح API.
- أدوات وموارد للتذاكر وجهات الاتصال والمحفظة وغيرها، بالصلاحيات وحدود الطلبات نفسها.
خطافات الويب الصادرة
- اشترك بنقاط استقبال في الأحداث العامة، مثل message.created.
- موقّعة بـ HMAC-SHA256 بصيغة Standard Webhooks (webhook-id وwebhook-timestamp وwebhook-signature).
- تُسلَّم مع إعادة المحاولة وتباعد متزايد، مع سجل للتسليم وإعادة إرسال يدوية.
توثيق الواجهة البرمجية
كل عملية ونطاقاتها وأخطاؤها، مولّدة من مستند OpenAPI.
في تطبيق نظام ربط بعد تسجيل الدخول