Referenser
Följande källreferenser har använts i framtagande av Utvecklarportalens REST API-profil.
Referenserna kan delas in i följande områden:
- API guider
- Internet Engineering Task Force ISO (RFC)
- Övriga
API guider
| Källa | URL |
|---|---|
| Microsoft REST API Guidelines | https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md |
| Paypal API Design Guidelines | https://github.com/paypal/api-standards/blob/master/api-style-guide.md |
| Australian Government API | https://api.gov.au/ |
| UK Government API Design Guidance | https://www.gov.uk/government/collections/api-design-guidance |
| Google Cloud API Design Guide | https://cloud.google.com/apis/design/ |
| Haufe API style guide | https://haufe-lexware.gitbooks.io/haufe-api-styleguide/content/ |
| Architectural Styles and the Design of Network-based Software Architectures | https://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm |
| REST APIs must be hypertext-driven | https://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven |
| Richardson Maturity Model:Steps toward the glory of REST | https://martinfowler.com/articles/richardsonMaturityModel.html |
| Architecture of the World Wide Web, Volume One | https://www.w3.org/TR/webarch/ |
Förutom de angivna källorna gällande design guidelines så ligger många olika RFC specifikationer bakom de rekommendationer som anges under Utvecklarportalen profil.
Internet Engineering Task Force (RFC)
| Källa | URL |
|---|---|
| RFC 2119 - Key words for use in RFCs to Indicate Requirement Levels | https://datatracker.ietf.org/doc/html/rfc2119 |
| RFC 2616 - Hypertext Transfer Protocol -- HTTP/1.1 | https://datatracker.ietf.org/doc/html/rfc2616 |
| RFC 3339 - Date and Time on the Internet: Timestamps | https://datatracker.ietf.org/doc/html/rfc3339 |
| RFC 3986 - Uniform Resource Identifier (URI): Generic Syntax | https://datatracker.ietf.org/doc/html/rfc3986 |
| RFC 4122 - A Universally Unique IDentifier (UUID) URN Namespace | https://datatracker.ietf.org/doc/html/rfc4122 |
| RFC 5789 - PATCH Method for HTTP | https://datatracker.ietf.org/doc/html/rfc5789 |
| RFC 5829 - Link Relation Types for Simple Version Navigation between Web Resources | https://datatracker.ietf.org/doc/html/rfc5829 |
| RFC 6454 - The Web Origin Concept | https://datatracker.ietf.org/doc/html/rfc6454 |
| RFC 7231 - Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content | https://datatracker.ietf.org/doc/html/rfc7231 |
| RFC 7239 - Forwarded HTTP Extension | https://datatracker.ietf.org/doc/html/rfc7239 |
| RFC 7807 - Problem Details for HTTP APIs | https://datatracker.ietf.org/doc/html/rfc7807 |
| RFC 8259 - The JavaScript Object Notation (JSON) Data Interchange Format | https://datatracker.ietf.org/doc/html/rfc8259 |
| RFC 8288 - Web Linking | https://datatracker.ietf.org/doc/html/rfc8288 |
| RFC 8594 - The Sunset HTTP Header Field | https://datatracker.ietf.org/doc/html/rfc8594 |
| RFC 9111 - HTTP Caching | https://datatracker.ietf.org/doc/html/rfc9111 |
Övriga
| Källa | URL |
|---|---|
| Open API specification | https://swagger.io/specification/ |
| Semantisk versionshantering | https://semver.org/lang/sv/ |
| The Deprecation HTTP Header Field | https://tools.ietf.org/id/draft-dalal-deprecation-header-01.html |
| W3C HTML 4.01 Specification | https://www.w3.org/TR/html401/ |
| HAL - JSON Hypertext Application Language | https://datatracker.ietf.org/doc/html/draft-kelly-json-hal-06 |