Skip to content

Commit e9c7747

Browse files
Merge pull request #12 from adidas/naming-conventions
Add naming conventions for collections - plurality
2 parents 0c08471 + f830368 commit e9c7747

File tree

1 file changed

+4
-0
lines changed

1 file changed

+4
-0
lines changed

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

+4
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)