API ব্যবহারকারী ও সামঞ্জস্য
VoiceStudio-এর কোন ইন্টারফেস সর্বজনীন, কোনটি শুধু ব্রাউজারের জন্য এবং কোনটি কখনো গ্রাহকের জন্য নয়।
কন্ট্রোল প্লেনের প্রতিটি অপারেশন একটি ব্যবহারকারী গোষ্ঠীর। একই OpenAPI উৎস ব্যবহার করলেই অপারেশন সর্বজনীন হয় না।
| ব্যবহারকারী | রুট | কে কল করে | এখানে প্রকাশিত? |
|---|---|---|---|
| সর্বজনীন ডেভেলপার API | /v1/* | সীমিত ক্ষমতার ডেভেলপার ক্রেডেনশিয়াল | হ্যাঁ, Cloud প্রজেকশনে |
| ওয়েবসাইট এজ API | পর্যালোচিত বেনামি /v1/marketing/* | সাইটের নিজস্ব ফর্ম | না |
| ড্যাশবোর্ড/BFF API | /dashboard/v1/* | একই উৎসের সেশনসহ ড্যাশবোর্ড | না |
| অপারেটর API | পর্যালোচিত /internal/v1/* | প্ল্যাটফর্ম অপারেটর | না |
| অভ্যন্তরীণ সার্ভিস API | অন্যান্য /internal/v1/* | ব্যক্তিগত সার্ভিস | না |
ওয়েবসাইট এজ, অপারেটর ও অভ্যন্তরীণ রুট কখনো গ্রাহক API-এর অংশ নয়। এগুলো এবং শুধু এগুলোর ব্যবহৃত স্কিমা /cloud-openapi.json-এ নেই। ব্রাউজার কখনো ডেভেলপার ক্রেডেনশিয়াল পায় না এবং সর্বজনীন ক্লায়েন্ট কখনো ড্যাশবোর্ড সেশন কুকি ব্যবহার করে না।
সামঞ্জস্য
পণ্যগুলোর মধ্যে কোনো সামঞ্জস্যপূর্ণ উপসেট প্রকাশিত হয়নি। স্থানীয় 0.5.0 ও Cloud প্রিভিউ 1.0.0 চুক্তি দুটিতেই POST /v1/audio/transcriptions আছে, কিন্তু ফিল্ড, প্রমাণীকরণ, Artifact ও Job-এর আচরণ, টাইমআউট ও ত্রুটি বিনিময়যোগ্য ঘোষণা করা হয়নি। নির্দিষ্ট সংস্করণ জোড়ার জন্য #71-এর আচরণগত পরীক্ষা পাস করতে হবে। ততদিন একই রুটের নাম মিল, সামঞ্জস্য নয়।
Cloud প্রকাশ
OpenAPI নথি বা চালানো যায় এমন উদাহরণে সক্রিয় Cloud সার্ভার প্রকাশ করা রিলিজের একটি ধাপ। ক্রমানুসারে প্রয়োজন:
- যাচাইকৃত প্রোডাকশন DNS ও TLS।
- প্রমাণীকরণ, সর্বজনীন রাউটিং ও গ্রাহকের জন্য নিরাপদ ব্যর্থতার স্মোক পরীক্ষা।
- নির্দিষ্ট সংস্করণের জন্য #71 সামঞ্জস্য ও রোলব্যাক পরীক্ষা।
- পুনরায় তৈরি প্রজেকশন যাতে আর
unavailableলেখা নেই।
রোলব্যাক সক্রিয় সার্ভার সরিয়ে দেয়। স্থায়ী Jobs, Artifacts ও idempotency রেকর্ড অপরিবর্তিত থাকে।