Az API élettartamát kevésbé az első verzió kódja határozza meg, mint az, hogy a régi kliensek meddig működnek tovább. A mobilfelhasználók hónapokig maradhatnak egy régi alkalmazásverzión. Ezért kockázatos egy mező eltávolítása vagy jelentésének megváltoztatása. Biztonságosabb mezőt hozzáadni, opcionális paramétereket elfogadni, a törő változtatásokat pedig új verziós útvonal alatt bevezetni.
Egységes hibaformátumot használjon, például az RFC 9457 (problem details) szabványt. A sebességkorlátozást a belépési pontnál, az alkalmazáslogika előtt alkalmazza. Minden válaszhoz csatoljon kérésazonosítót, és naplózza azt, hogy a szerveres naplóbejegyzést össze lehessen párosítani a kliens által jelentett hibával. Ez a három döntés jelentősen csökkenti egy közzétett API későbbi javításának költségét.
Hasonló projektet tervez?
Közösen át tudjuk beszélni, hogyan jelenik meg a cikkben tárgyalt téma az ön termékében.
