REST API DesignConventions that make an API predictable, and the ones worth arguing about.ComputingConventions, not laws — but breaking them surprises every consumer.URLs/users – collection/users/42 – one item/users/42/orders – nestedPlural nouns, no verbsLowercase, hyphen-separatedMethodsGET list or readPOST createPUT replacePATCH update fieldsDELETE removeResponses201 + Location on create204 on deleteConsistent error shapePaginate every collectionVersioning/v1/users – in the pathAccept header – purer, less visibleNever break v1 silentlyPaginate collections from the first version. Adding pagination later is abreaking change for every client.REST API Designlearnposters.com
REST API Design — printable computing wall chart from LearnPosters. Free vector PDF, US Letter and A4.

What’s on the REST API Design poster

17 entries in 4 groups.

Conventions, not laws — but breaking them surprises every consumer.

Paginate collections from the first version. Adding pagination later is a breaking change for every client.

Questions about the REST API Design poster

What’s on the REST API Design poster?
17 entries in 4 groups. Conventions, not laws — but breaking them surprises every consumer. URLs: /users – collection, /users/42 – one item, /users/42/orders – nested, Plural no…; Methods: GET list or read, POST create, PUT replace, PATCH update fields, DELETE remove; Responses: 201 + Location on create, 204 on delete, Consistent error shape, Paginate…; Versioning: /v1/users – in the path, Accept header – purer, less visible, Never break…. Paginate collections from the first version. Adding pagination later is a breaking change for every client.
Who is the REST API Design poster for?
REST API Design belongs to the Computing section rather than to a school year, because computing is not something one grade owns. Anyone learning languages can pin it up — a beginner, a student mid-course, or someone revising years later.
When should you use the REST API Design poster?
Nouns for resources, verbs from HTTP. If a URL contains a verb, look again. A wall chart earns its place by being glanceable from where the work is happening, so REST API Design belongs on the wall where that computing work actually happens, within glancing distance, rather than filed away.
What other posters go with REST API Design?
Bash Scripting, Error Handling and Branching Models sit alongside REST API Design in the Computing section. Printed together they make a wall rather than a single sheet, which is how a reference set actually gets used.Bash ScriptingError HandlingBranching Models
Is the REST API Design poster free to download and print?
Yes. REST API Design downloads as a free PDF with no account, no email and no watermark, like everything else in the Computing section. Print as many copies as you like for a home, a classroom, a library or a tutoring group; reselling the file is the only thing the licence rules out.Read the licence
What size does the REST API Design poster print at?
REST API Design is a vector PDF laid out for US Letter, and prints on A4 with Fit to page — the same file, no separate download. Because every mark on it is drawn rather than photographed, it stays sharp enlarged to A3, A2 or A1 at a copy shop. Colour carries emphasis only, so a greyscale print of REST API Design loses nothing.Printing guide

Related posters

Charts that sit alongside REST API Design on the same wall.

Browse every Computing poster, or start from the full catalogue.