Skip to content

Commit ea37ea9

Browse files
Merge branch 'master' into changes/API-165
2 parents f2ac23c + d34423f commit ea37ea9

File tree

2 files changed

+363
-291
lines changed

2 files changed

+363
-291
lines changed

rest-api-guidelines/evolution/naming-conventions.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,10 @@ Every identifier **MUST** be in American English and written in `lowercase`. An
1313

1414
Every URI **MUST** follow the General Rules except for the `camelCase` rule. Instead, a hyphen \(`-`\) **SHOULD** be used to delimit combined words \(kebab-case\). Besides, a URI **MUST NOT** end with a trailing slash \(`/`\).
1515

16+
Plural nouns SHOULD be used in the URI where appropriate to identify collections of data resources (e.g. ``/orders``, ``/products``).
17+
18+
An individual resource in a collection of resources MAY exist directly beneath the collection URI. (e.g. ``/orders/{order_id}``).
19+
1620
#### Example
1721

1822
A well-formed URI:

0 commit comments

Comments
 (0)