Section: Route shape examples

Use stable path identifiers

text
text
GET /users/123
GET /orders/ord_456
Explanation

Stable identifiers make URLs shareable and cache-friendly. Avoid path values that change often.

Learn the surrounding workflow

Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.

Related commands

Same sheet · prioritizing Route shape examples
Prefer nouns over verbs
Model the resource, not the action name.
OpenIn sheettextsame section
Use plural collection names
Keep collection naming consistent.
OpenIn sheettextsame section
Represent actions carefully when needed
Use an action subresource only for non-CRUD workflows.
OpenIn sheettextsame section
List a collection
Fetch a list of users.
OpenIn sheethttp1 tag match
Create a resource
Create a new user in the collection.
OpenIn sheethttp1 tag match
Fetch a single resource
Read one user by identifier.
OpenIn sheethttp1 tag match