From a8e010e2049957cd4364321170746714d8f5f45b Mon Sep 17 00:00:00 2001 From: apidesigner Date: Mon, 27 Feb 2017 10:23:18 +0000 Subject: [PATCH] Updates evolution/json.md Auto commit by GitBook Editor --- evolution/json.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) 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": []`) +