Skip to content

Instantly share code, notes, and snippets.

@Anthgg
Anthgg / rest_best_practices.json
Created September 8, 2026 05:05
BountyBook rest_best_practices.json deliverable
[
{
"practice": "Use resource nouns in paths and let HTTP methods express the action.",
"category": "url-design",
"good_example": "GET /users/123",
"bad_example": "GET /getUser?id=123",
"rationale": "Resource-oriented paths make APIs predictable because the verb is already carried by the HTTP method.",
"http_methods_involved": ["GET", "POST", "PUT", "PATCH", "DELETE"],
"references": ["RFC 9110 HTTP Semantics", "Roy Fielding REST dissertation"]
},