نسخه API: '/v1/'، 'پذیرش: نسخه'، 'نام مستعار GraphQL'
این مهم است که هر دو در هنگام مقیاس پذیری پلت فرم و هنگام اجرای به روز رسانی، تست و یا خدمات مشتریان قدیمی.
روش های نسخه بندی
| توضیحات و مزایا | ||
|---|---|---|
| نسخه در URL ('/v1/') | راه قابل فهم ترین و محبوب - مناسب برای REST API | |
| هدر را بپذیرید | مثال: "Accept: application/vnd. API + JSON ؛ version = 2 '- داده ها را از نسخه جدا می کند | |
| نام مستعار GraphQL/versioned fields | نسخههای مختلف از طریق نام مستعار: 'userV1', 'userV2' - مناسب برای مهاجرت تدریجی | |
| نسخه های سطح Schema | طرح ها و ماژول های جداگانه در OpenAPI/Swagger برای هر نسخه |
چگونه اجرا می شود
ساختار API با '/v1/'، '/v2/' و مسیرهای مستقل
بررسی سرآیند «Accept» و «X-API-Version»
GraphQL از نامهای مستعار و طرحوارههای نسخهبندی شده پشتیبانی میکند ('userV1', 'userV2')
توانایی تست A/B نسخه های جدید بدون خطر برای تولید
ثبت تماس به هر نسخه برای تجزیه و تحلیل و مهاجرت
مزایای کسب و کار و ادغام
پشتیبانی از مشتریان قدیمی بدون کاهش سرعت
عملیات موازی API چند نسل
با خیال راحت پیاده سازی ویژگی های جدید بدون شکستن سازگاری به عقب
انعطاف پذیری برای مقیاس و ارتقاء زیرساخت
مهاجرت یکپارچه بین نسخه های کنترل شده و تحلیلی
جایی که بسیار مهم است
پلتفرمهایی با چندین مشتری خارجی
پروژه ها با رویکرد API-first و چرخه عمر طولانی
ادغام با بانک ها، ارائه دهندگان، شرکای B2B
سیستم هایی با مشتریان تلفن همراه یا IoT طولانی مدت
نسخه API پایه و اساس قابلیت اطمینان و انعطاف پذیری در ادغام است. صرف نظر از فرمت (REST، GraphQL یا gRPC)، ما اطمینان از توسعه امن رابط ها - بدون شکست، درگیری و از دست دادن سازگاری.
تماس با ما
لطفاً فرم زیر را پر کنید، در اسرع وقت پاسخ خواهیم داد.