References
This section collects links to documents to which we refer, and base our guidelines on.
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