GitBook: [master] 102 pages and one asset modified

rest-api-guidelines/rest.md

@@ -0,0 +1,43 @@
+# Introduction
+
+## ![](../.gitbook/assets/adidas-logo.svg)
+
+## adidas REST API Guidelines
+
+The adidas REST API Guidelines defines standards and guidelines for building REST APIs at adidas. **These Guidelines has to be followed in addition to the adidas** [**General API Guidelines.**](../general-guidelines/general-guidelines.md)
+
+The REST API Guidelines are further split into the following parts:
+
+* **Core Principles**
+
+  REST API Guidelines Core Principles defines the rules that **MUST** be followed at throughout the full API lifecycle.
+
+* **Functionality Guidelines**
+  * [**Protocol level**](https://adidas-group.gitbooks.io/api-guidelines/content/protocol/)
+
+    Protocol guidelines define the protocols used within the organization.
+
+  * [**Message level**](https://adidas-group.gitbooks.io/api-guidelines/content/message/)
+
+    The Message guidelines define the structure and semantics of messages used to exchange information.
+
+  * [**Application level**](https://adidas-group.gitbooks.io/api-guidelines/content/application/)
+
+    The Application guidelines define the definition and use of application-specific semantics.
+* **Quality Guidelines**
+
+  Evolution and Execution guidelines define the rules for achieving the desired architectural qualities of systems.
+
+  * [**Evolution**](https://adidas-group.gitbooks.io/api-guidelines/content/evolution/)
+
+    Evolution qualities governance, such as testability, maintainability, extensibility, and scalability.
+
+  * [**Execution**](https://adidas-group.gitbooks.io/api-guidelines/content/execution/)
+
+    Execution qualities governance, such as security and usability.
+
+* **Guides** Guides and materials supporting the REST API Guidelines
+* **API Clients**
+
+  Section dedicated to consumers of adidas APIs
+