Guida alla progettazione di API HTTP
Questa guida descrive un insieme di pratiche per la progettazione di API HTTP+JSON, originariamente tratte dal lavoro sulle API della Piattaforma Heroku.
La guida serve come riferimento sia per le modifiche alle API correnti che per lo sviluppo di nuove API all'interno di Heroku; speriamo sia di interesse per tutti gli API designer anche al di fuori di Heroku.
I nostri obiettivi sono la coerenza ed il focalizzarsi sulla logica di business, evitando inutili perdite di tempo durante la progettazione. Perseguiamo un metodo ottimale, coerente e ben documentato per progettare API, che non sia necessariamente l'unico e solo modo ideale di farlo.
Diamo per scontato che tu abbia già familiarità con i principi alla base delle API HTTP+JSON, quindi questa guida non comprende tutta la parte teorica fondamentale sull'argomento.
La guida è disponibile in diversi formati a questo link gitbook
Accettiamo volentieri contributi alla guida.
Vai al Sommario per l'indice dei contenuti.
Traduzioni
- Versione in Portoghese (based on fba98f08b5), di @Gutem
- Versione in Spagnolo (based on 2a74f45), di @jmnavarro
- Versione in Coreano (based on f38dba6), di @yoondo
- Versione in Cinese Semplificato (based on 337c4a0), di @ZhangBohan
- Versione in Cinese Tradizionale (based on 232f8dc), di @kcyeu
- Versione in Turco (based on c03842f), di @hkulekci