المطورون
الـ API موجود. أما المرجع العام فليس موجودًا، حتى الآن.
كل ما على هذه المنصة، أي المتجر والسلة ولوحة التحكم، يتواصل بالفعل مع API واحد. ما لم نفعله هو نشره: لا توجد اليوم رموز وصول للعملاء ولا توثيق مرجعي، ونفضّل أن نقول ذلك على أن نبيعك لقطة شاشة.
اليوم
ما هو صحيح فعلًا الآن.
المتجر ولوحة التحكم يعملان بالفعل على API داخلي خاص بنا. نشره يعني توثيقًا وإصدار رموز وصول ووعودًا بالاستقرار يمكننا الوفاء بها، ولا شيء من ذلك موجود بعد.
ما ليس موجودًا بعد: مفاتيح API يمكنك إنشاؤها بنفسك، ومرجع منشور مع المخططات، ووعود الاستقرار التي تجعل الـ API جديرًا بالبناء عليه. إلى أن نتمكن من كتابة سياسات الإصدارات والإيقاف، لن نوزّع رموز وصول، فالـ API الذي يتغير من تحتك أسوأ من عدم وجود API.
إن كان سير عملك يحتاج إلى تجهيز برمجي اليوم، فأخبرنا بما تبنيه عبر نموذج الاستفسار. الاهتمام يحدد فعلًا ترتيب ما نبنيه، وسيبدأ الوصول المبكر بمن طلبوه.
الواجهة المخطط لها
ما الذي ستغطيه واجهة API العامة.
هذه هي القدرات الموجودة بالفعل في الـ API الداخلي وسيتيحها الـ API العام. مخطط له يعني مخطط له: لا شيء منها متاح للعملاء لاستدعائه اليوم.
- دورة حياة الخادم
- أنشئ الخوادم وأعد بناءها وأعد تشغيلها واحذفها من شيفرتك الخاصة: العمليات التي تنفّذها لوحة التحكم اليوم.
- الكتالوج المباشر
- الخطط والمناطق وصور النظام كبيانات، بالأسعار نفسها التي يعرضها المتجر، بما في ذلك خصم الشريك حيث ينطبق.
- النطاقات وDNS
- ابحث عن النطاقات وسجّلها وأدر سجلاتها من خلال تكامل المسجّل نفسه الذي يستخدمه الموقع.
- الاستخدام والفوترة
- قياس استهلاك ساعة بساعة يمكنك قراءته برمجيًا: الأرقام التي تحتاجها لإعادة فوترة عملائك.
- Webhooks بدلًا من الاستعلام المتكرر
- أحداث دورة الحياة تُرسل إلى نقطة النهاية لديك موقّعة، لتتفاعل أنظمتك بدلًا من أن تسأل.
- رموز وصول محددة الصلاحيات
- مفاتيح للقراءة فقط، أو للتجهيز فقط، أو بصلاحيات كاملة، قابلة للإلغاء فورًا، مع سجلات تدقيق لكل رمز.
المبادئ التي نبني وفقها: REST بسيط مع رموز حالة ذات معنى، ومفاتيح idempotency في الاستدعاءات التي تُحدث تغييرات، وcloud-init user_data عند الإنشاء، وحدود معدّل الطلبات مذكورة في ترويسات الاستجابة، وأخطاء تخبرك بما تفعله بعد ذلك. ممل عن قصد.
سجّل اهتمامك
أخبرنا بما ستبنيه به.
تكفي جملة واحدة عن حالة استخدامك. سنتواصل معك عندما يكون هناك شيء حقيقي لتجربته، لا سلسلة رسائل تسويقية.