Introduction · HTTP API Design

Powered by GitBook

Introduction

HTTP API Design Guide

This guide describes a set of HTTP+JSON API design practices, originally<br>extracted from work on the Heroku Platform API.

This guide informs additions to that API and also guides new internal<br>APIs at Heroku. We hope it’s also of interest to API designers<br>outside of Heroku.

Our goals here are consistency and focusing on business logic while<br>avoiding design bikeshedding. We’re looking for a good, consistent,<br>well-documented way to design APIs, not necessarily the only/ideal<br>way.

We assume you’re familiar with the basics of HTTP+JSON APIs and won’t<br>cover all of the fundamentals of those in this guide.

Available for online reading and in multiple formats at gitbook.

We welcome contributions to this guide.

See Summary for Table of Contents.

Translations

Portuguese version (based on fba98f08b5), by @Gutem

Spanish version (based on 2a74f45), by @jmnavarro

Korean version (based on f38dba6), by @yoondo

Simplified Chinese version (based on 337c4a0), by @ZhangBohan

Traditional Chinese version (based on 232f8dc), by @kcyeu

Turkish version (based on c03842f), by @hkulekci

results matching ""

No results matching ""