المطوّرون
واجهة برمجية أولًا، لا لاحقًا.
كل ما تفعله الواجهة يمكن فعله برمجيًا. المنصة التي تُبقي قدرات لنفسها ليست منصة.
الواجهة البرمجية
REST بمفاتيح لكل منظمة
أنشئ مفتاحًا من حسابك، وأبطله متى شئت. المفاتيح مخزّنة مجزّأة ولا تُعرض إلا مرة واحدة.
- 01
المفاتيح
بيئة الاختبار والإنتاج مميّزة داخل المفتاح نفسه، فلا تختلط.
- 02
الصلاحيات
المفتاح يرث صلاحيات منظمته، لا أكثر.
التوثيق
توثيق يطابق السلوك
التوثيق الذي يتأخّر عن الشيفرة أسوأ من غيابه، لأنه يجعلك تثق بشيء خاطئ.
- 01
المرجع
كل نقطة نهاية بمدخلاتها ومخرجاتها وأخطائها.
- 02
الأخطاء
رموز أخطاء ثابتة ورسائل مفهومة، لا نصوص عامة.
حزم التطوير
حزم للغات الشائعة
غلاف رقيق حول الواجهة البرمجية. تُبقي الحزمة رقيقة كي لا تتخلّف عن الواجهة.
- 01
JavaScript و TypeScript
أنواع كاملة، تعمل في الخادم والمتصفح.
- 02
لغات أخرى
الواجهة REST قياسية، فأي عميل HTTP يكفي إن لم تكن لغتك مدعومة بحزمة.
ويب هوك
أحداث موقّعة
كل حدث موقّع، والتوقيع هو ما يجعل استقباله آمنًا. تحقّق منه دائمًا قبل التنفيذ.
- 01
الأحداث
الطلبات والمدفوعات والتراخيص والاشتراكات.
- 02
إعادة المحاولة
تُعاد المحاولة عند الفشل، فاجعل معالجتك متكرّرة الاستدعاء بأمان.