Pagina 1 di 1
Tra GraphQL, gRPC e tRPC, REST sembra fuori moda. Nella pratica, per la maggior parte delle API B2B, REST scritto bene continua a essere la scelta corretta: cache HTTP nativa, debugging con strumenti standard, learning curve nulla per i client. La differenza la fa il design degli endpoint e la gestione del versioning.
In questa categoria scrivo di REST API scritto bene: design degli endpoint con HATEOAS pragmatico, versioning per API usate da 40 integratori terzi (esperienza diretta), gestione coerente degli errori con Problem Details RFC 7807, idempotenza tramite chiavi sui metodi non-idempotenti come POST.
Se hai un'API REST da disegnare o rifare, parliamone. Oppure scopri come lavoro.
Ho ereditato un'API Laravel usata da 40 integratori terzi senza versioning. Aggiungere un campo obbligatorio era un problema diplomatico prima che tecnico. Vi mostro le strategie di versioning che ho adottato, come ho introdotto il versioning retroattivamente e il contratto di deprecation che uso con i clienti API. Continua a leggere
