Toisc go ndéanann seirbhísí fhíor-dhéplóid go neamhspleách, ní féidir leat a bheith i ndon a thoimhdiú go soláthraítear glaochanna suas in idirlíne. Leagáil API móide comhoiriúnacht siar-bhraistint a bhaint úsáide as ligean do tháirgeoirí fás gan imeall ar thomhaltóirí atá ann cheana.
| Straitéis | Sampla |
|---|
| Cosán URI | GET /v2/orders/42 |
| Ceanntásc | Accept: application/vnd.api.v2+json |
| Éabhlóid scéimh | réimsí a chur leis, ní dheirtear riamh/athainmnigh |
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
}
Uimhreacha páirc, ní hainmneacha, a shainiú an fhormáid sreabhadh, mar sin tá réimsí a chur leis comhoiriúnach siar-bhraistint.
Release v2 ─▶ run v1 + v2 together ─▶ migrate consumers ─▶ deprecate v1 ─▶ remove v1
Na bac riamh a bhaint as leagan nuair atá fíor-thraific fós ag úsáid sé. Rianú úsáid sula riar.
Níl neamhspléachas imshuíomh ag feidhmiú ach amháin má is féidir le táirgeoir athrú a seachadadh gan gealltanas gach tomhaltóir a chur i gcomhordú.
Dréachtú do athrú additive agus tacaíocht a thabhairt do sheanchuid leagain le linn imirce an rud atá i gceist ag a choinneáil ar an neamhspléachas sin seachas brúnna imilt bog-bhang a dhéanamh.