References

This section collects links to documents to which we refer, and base our guidelines on.

OpenAPI Specification:

• OpenAPI Specification;

Publications, specifications and standards:

• RFC 3339: Date and Time on the Internet: Timestamps;

• RFC 5988: Web Linking;

• RFC 7159: The JavaScript Object Notation (JSON) Data Interchange Format;

• RFC 7230: Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing;

• RFC 7231: Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content;

• RFC 7807: Problem Details for HTTP APIs;

• ISO 8601: Date and time format;

• ISO 3166-1 alpha-2: Two letter country codes;

• ISO 639-1: Two letter language codes;

• ISO 4217: Currency codes;

• BCP 47: Tags for Identifying Languages;

Dissertations:

• Roy Thomas Fielding - Architectural Styles and the Design of Network-Based Software Architectures. This is the text which defines what REST is;

Books:

• REST in Practice: Hypermedia and Systems Architecture;

• Build APIs You Won’t Hate;

• InfoQ eBook - Web APIs: From Start to Finish;

Blogs:

• Lessons-learned blog: Thoughts on RESTful API Design;