فئات مستخدمي API والتوافق
واجهات VoiceStudio العامة والمخصصة للمتصفح فقط والتي لا تُقدّم للعملاء مطلقًا.
تنتمي كل عملية في مستوى التحكم إلى فئة مستخدمين واحدة. لا يجعل اشتراك العمليات في مصدر OpenAPI العملية عامة.
| الفئة | المسارات | الجهة المستدعية | منشور هنا؟ |
|---|---|---|---|
| واجهة المطور العامة | /v1/* | بيانات اعتماد مطور محددة النطاق | نعم، في إسقاط Cloud |
| واجهة حافة الموقع | /v1/marketing/* المجهول الذي تمت مراجعته | نماذج الموقع نفسه | لا |
| واجهة لوحة التحكم/BFF | /dashboard/v1/* | لوحة التحكم بجلسة من الأصل نفسه | لا |
| واجهة المشغل | /internal/v1/* الذي تمت مراجعته | مشغلو المنصة | لا |
| واجهة الخدمات الداخلية | مسارات /internal/v1/* الأخرى | خدمات خاصة | لا |
مسارات حافة الموقع والمشغل والمسارات الداخلية ليست واجهات API للعملاء مطلقًا. وهي غائبة عن /cloud-openapi.json، بما في ذلك المخططات الخاصة بها فقط. لا تتلقى المتصفحات بيانات اعتماد المطور مطلقًا، ولا يستخدم العملاء العموميون ملف تعريف ارتباط جلسة لوحة التحكم.
التوافق
لم تُصدر أي مجموعة توافق فرعية بين المنتجات. يتضمن عقد الإصدار المحلي 0.5.0 ومعاينة Cloud 1.0.0 المسار POST /v1/audio/transcriptions، لكن الحقول والمصادقة وسلوك Artifact وJob والمهل والأخطاء لم يُعلن أنها قابلة للتبادل. يتطلب ذلك اجتياز اختبارات السلوك في #71 لزوج إصدارات محدد. وحتى ذلك الحين، يعني الاسم المشترك للمسار تداخلًا لا توافقًا.
إصدار Cloud
نشر خادم Cloud نشط في مستند OpenAPI أو أمثلة قابلة للتنفيذ خطوة إصدار. وتتطلب بالترتيب:
- DNS وTLS للإنتاج تم التحقق منهما.
- اختبارات أولية للمصادقة والتوجيه العام والإخفاقات الآمنة للعملاء.
- فحوص توافق وتراجع #71 للإصدارات المحددة بدقة.
- إسقاطًا أُعيد توليده ولم يعد يعرض
unavailable.
يزيل التراجع الخادم النشط. تبقى Jobs وArtifacts وسجلات idempotency الدائمة كما هي.