Modificări de API
Modificări incompatibile, depreciere și versionare, explicate celor afectați.
-
Versionarea API Stripe: cum funcționează și ce poți copia
Versionarea API Stripe fixează fiecare cont pe o versiune datată și lasă orice cerere să o înlocuiască. Cum merge, cât costă și ce poate copia un API mic.
Modificări de API7 min de citit
-
Schimbări incompatibile în Protobuf: ce rezistă pe wire
Schimbările incompatibile în Protobuf apar pe wire, nu în URL. Unele schimbări de câmp gRPC sunt gratis, altele rup clienții în tăcere, deși arată la fel.
Modificări de API6 min de citit
-
Deprecierea GraphQL fără un număr de versiune
GraphQL nu are v1 sau v2 în URL. Câmpurile sunt depreciate unul câte unul cu o directivă, pe o schemă comună, ceea ce schimbă ce datorează un changelog.
Modificări de API6 min de citit
-
Cum scrii un ghid de migrare API
Un ghid de migrare API transformă o schimbare incompatibilă într-o listă de verificare, nu într-o pană. Ce trebuie să conțină și de ce o intrare nu ajunge.
Modificări de API5 min de citit
-
Changelog-uri de API interne: ce se schimbă
Un changelog de API public are un public pe care nu îl poți contacta. Unul intern are un public la două etaje distanță, iar asta schimbă ce i se cuvine.
Modificări de API6 min de citit
-
Changelog-uri de webhook: schimbarea necerută
O schimbare de payload la webhook se strică în tăcere, pentru că nimeni n-o poate respinge. Ce o face să rupă compatibilitatea, și cum se versionează.
Modificări de API6 min de citit
-
Header-ul Sunset al unui API și când să-l trimiți
Header-ul Sunset spune unui client când o versiune încetează să răspundă, spre deosebire de o depreciere. Ce acoperă RFC 8594 și ce aduce un brownout.
Modificări de API5 min de citit
-
Changelog de API: ce publici și cine îl citește
E citit de oameni care decid dacă codul lor va mai funcționa luna viitoare. Ce le datorează fiecare intrare, unde locuiește changelog-ul, cum se abonează.
Modificări de API7 min de citit
-
Cum se depreciază un API fără a pierde dezvoltatorii
Deprecierea e o promisiune cu o dată. Programul, șablonul de notificare, header-ele de răspuns, și pasul care oprește un sunset să devină un incident.
Modificări de API6 min de citit
-
Cele mai bune practici de versionare API, pentru apelanți
Versionați doar ce rupe compatibilitatea, puneți versiunea unde apelanții o văd, și mențineți-o pe cea veche până la o dată. Patru scheme comparate.
Modificări de API8 min de citit
-
Schimbări care rup compatibilitatea și cum le lansezi
O schimbare care rupe compatibilitatea e orice pe care un apelant corect n-ar fi supraviețuit. Ce contează, ce nu, cum o prinzi în CI și cum o lansezi.
Modificări de API10 min de citit
