Saboda saitin suna sauka da kaɓihewar, ba za ku iya tunanin cewa kira masu ƙarshen sauri a wajin. API tsarin bukatun da kuma bantuwa ta girma-gida yana ba wahalaye damar yin haɓakawa ba tare da karye masu amfani da jiya.
Saboda saitin suna sauka da kaɓihewar, ba za ku iya tunanin cewa kira masu ƙarshen sauri a wajin. API tsarin bukatun da kuma bantuwa ta girma-gida yana ba wahalaye damar yin haɓakawa ba tare da karye masu amfani da jiya.
| Dabarun | Misali |
|---|
| Hanya URI | GET /v2/orders/42 |
| Jagorar | Accept: application/vnd.api.v2+json |
| Samuwar tsarin | saka ketare, kada a toshi/sake suna kada kadan |
NON-BREAKING (safe):
✓ add a new optional field
✓ add a new endpoint
✓ add a new enum value (if clients tolerate unknowns)
BREAKING (needs a new version):
✗ remove or rename a field
✗ change a type or make a field required
✗ change semantics of an existing field
message Order {
string id = 1;
double total = 2;
string currency = 3; // NEW field 3 — old clients ignore it safely
}
Nambari na ketare, ba suna ba, suna bayyana tsarin waya, don haka saka ketare yana bantuwa ta girma-gida.
Release v2 ─▶ run v1 + v2 together ─▶ migrate consumers ─▶ deprecate v1 ─▶ remove v1
Kada bugi suna a lokacin da kasua da gaske har yanzu ke amfani da ita. Bi aiki kafin retire.
Gajeren kaɓihewar aiki kawai yana aiki idan wahalaye na iya aika sauye ba tare da magangare kwan burin kowa ba.
Tsarin don sauye-sauye da shaida da tsofaffin suna a lokacin mika-mika shine abin da ke tsare wannan kaɓihewar maimakon tilasta hauhawar big-bang masu niri.