diff --git a/core-principles/README.md b/core-principles/README.md index de404b4..ad6bcca 100644 --- a/core-principles/README.md +++ b/core-principles/README.md @@ -1,3 +1,2 @@ # Core Principles - This section outlines the foundation upon which the API Guidelines are built. \ No newline at end of file diff --git a/guidelines/README.md b/guidelines/README.md deleted file mode 100644 index 5a3e728..0000000 --- a/guidelines/README.md +++ /dev/null @@ -1 +0,0 @@ -# API Design Guidelines diff --git a/protocol/README.md b/protocol/README.md new file mode 100644 index 0000000..dab1c36 --- /dev/null +++ b/protocol/README.md @@ -0,0 +1,3 @@ +# Protocol Guidelines +This section outlines the protocol-level semantics and guidelines. + diff --git a/guidelines/content-negotiation.md b/protocol/content-negotiation.md similarity index 89% rename from guidelines/content-negotiation.md rename to protocol/content-negotiation.md index c5865e7..8ad3327 100644 --- a/guidelines/content-negotiation.md +++ b/protocol/content-negotiation.md @@ -1,5 +1,4 @@ # Content Negotiation -MOVE TO PROTOCOL SEMANTICS https://tools.adidas-group.com/confluence/display/EA/API+Versioning+and+Compatibility diff --git a/protocol/http.md b/protocol/http.md new file mode 100644 index 0000000..c92289d --- /dev/null +++ b/protocol/http.md @@ -0,0 +1,12 @@ +# HTTP +Every API MUST support [HTTP/1.1](https://tools.ietf.org/html/rfc7230). + +> [RFC 7230, HTTP/1.1: Message Syntax and Routing](https://tools.ietf.org/html/rfc7230) +> [RFC 7231, HTTP/1.1: Semantics and Content](https://tools.ietf.org/html/rfc7231) +> [RFC 7232, HTTP/1.1: Conditional Requests](https://tools.ietf.org/html/rfc7232) +> [RFC 7233, HTTP/1.1: Range Requests](https://tools.ietf.org/html/rfc7233) +> [RFC 7234, HTTP/1.1: Caching](https://tools.ietf.org/html/rfc7234) +> [RFC 7235, HTTP/1.1: Authentication](https://tools.ietf.org/html/rfc7234) + + +