ابنِ على الوكيل
واجهة برمجية من خادم إلى خادم: أنشئ عملاء، أرسل رسائل العملاء ليجيب عنها الوكيل، اقرأ المحادثات والاستخدام، واستقبل الأحداث عبر webhooks موقّعة. سندبوكس أولاً، ثم الإنتاج بنفس الكود.
البداية السريعة
من إنشاء تطبيق سندبوكس إلى أول رد من الوكيل في خمس دقائق.
المصادقة
OAuth 2.0 client credentials، رموز ES256 لعشر دقائق، لا refresh tokens.
مرجع الواجهة
كل نقطة نهاية ومخططاتها من OpenAPI المولّد من الكود نفسه.
Webhooks
توقيع HMAC-SHA256، نافذة إعادة تشغيل، تدوير بمفتاحين، إعادة محاولة.
المبادئ
JSON UTF-8 · ISO-8601 بتوقيت UTC · المال بالهللة كعدد صحيح · ترقيم بالمؤشر · Idempotency-Key على الكتابة · X-Request-Id في كل رد · أخطاء RFC 9457.
لا يُقبل organization_id من العميل أبداً: المنظمة تُربط من الرمز، وقاعدة البيانات تعزل الصفوف مرة ثانية. أي معرّف من منظمة أخرى هو 404.
إضافات فقط داخل v1، وسياسة إيقاف معلنة (ستة أشهر لنقطة نهاية، ثلاثة لحقل).
الاكتشاف
GET https://api.antisandbox.com/v1
GET https://api.antisandbox.com/openapi.json
GET https://api.antisandbox.com/.well-known/oauth-authorization-server
GET https://api.antisandbox.com/.well-known/oauth-protected-resource
GET https://api.antisandbox.com/.well-known/jwks.jsonBase: https://api.antisandbox.com/v1