Versiyalash

Versiya yo'lda turadi: /integration/v1.

v1 ichida nima o'zgarmaydi

• Mavjud maydon o'z nomi va turini saqlaydi.
• Mavjud amal o'z yo'li, metodi va ma'nosini saqlaydi.
• Xatolik kodi o'z raqamini saqlaydi va o'sha narsani anglatishda davom etadi.
• Ruxsat (scope) satri o'z nomini saqlaydi.

Oxirgisi ko'ringanidan muhimroq: ruxsat satrlari sotuvchilar allaqachon bergan kalitlarda saqlanadi, ya'ni birortasining nomini o'zgartirish uni olib yurgan har bir kalitni sindiradi. Ular doimiy deb qaraladi.

v1 ichida nima o'zgarishi mumkin

• Mavjud javoblarda yangi maydonlar paydo bo'ladi. Tanimaganini e'tiborsiz qoldiring; xato tashlamang.
• Yangi amallar paydo bo'ladi.
• So'rovlarda yangi ixtiyoriy maydonlar paydo bo'ladi.
• Yangi xatolik kodlari paydo bo'ladi. Notanish nolga teng bo'lmagan code ni dastur qulashi emas, umumiy xatolik sifatida qayta ishlang.
• Xabar matni qayta yoziladi. Hech qachon message bo'yicha moslashtirmang — buning uchun code bor.

Generatsiya qilingan klient notanish javob maydonlariga chidamli bo'lishi kerak. Ko'p generatorlar buni sukut bo'yicha bajaradi; ba'zilarini rad etishga sozlash mumkin, va o'sha sozlama maydon qo'shilgan relizda sizni sindiradi.

Buzuvchi o'zgarish nima ko'rinishda bo'ladi

Maydonni olib tashlash, nomini yoki turini o'zgartirish, yoki amalning vazifasini o'zgartirish. Bular yangi yo'l sifatida /integration/v2 ga o'tadi. Ikkalasi mavjud bo'lgan vaqtda /integration/v1 ishlashda davom etadi.

Nega bu versiya Bione'nikidan alohida

Bione'ning o'z ilovalari /v1 bilan gaplashadi va o'sha raqam Bione'ning reliz jadvali bo'yicha o'zgaradi. Sizniki esa yo'q — /integration/v1 o'z o'qiga ega, shuning uchun ichki katta reliz integratsiyangiz tayanadigan yo'lni siljita olmaydi.

Qo'llab-quvvatlashni to'xtatish

Agar biror amal yoki maydon olib tashlanadigan bo'lsa, u ishlashdan to'xtashidan oldin o'zgarishlar sahifasida e'lon qilinadi va e'lon qilingan muddat davomida ishlashda davom etadi. Amaldagi versiyadan hech narsa ogohlantirishsiz olib tashlanmaydi.