diff --git a/evolution/json.md b/evolution/json.md index 0926460..cbb30dd 100644 --- a/evolution/json.md +++ b/evolution/json.md @@ -1,6 +1,11 @@ # JSON Format Conventions -Any JSON-based message **MUST** conform to the rules outlined in this section. +Any JSON-based message **MUST** conform to these rules -## Follow the Naming Conventions -All JSON fields MUST follow the [Naming Conventions]() (use `snake_case`, US. English etc.) \ No newline at end of file +- All JSON field names **MUST** follow the [Naming Conventions](https://adidas-group.gitbooks.io/api-guidelines/content/evolution/naming-conventions.html) (`snake_case`, American English etc.) +- Field names **MUST** be ASCII alpha num characters, underscore (`_`) or dollar sign (`$`) +- Boolean fields **MUST NOT** be of `null` value +- Fields with `null` value **SHOULD** be omitted +- Empty arrays and objects **SHOULD NOT ** be `null` (use `[]` or `{}` instead) +- Array field names **SHOULD** be plural (e.g. `"orders": []`) +