Comment on page
API Design Guide
This is the home of the API Design Guide published by Stafrænt Ísland as a best practice guide for API development. It should help synchronize the work between developers and make working together easier. The guide covers the relevant design principles and patterns to use so the consumer experience is enjoyable and consistent throughout APIs.
This guide is under constant review and updates will be made over time as new design patterns and styles are adopted.
All feedback is welcomed and encouraged to help make the guide better so please feel free to create pull requests.
Draft 4 - Published 2023-06-07
- Updated usage of HTTP status codes to use
204
instead of404
when resources are not found or not accessible to the user. - Update REST Requests to describe arrays in query parameters and how to handle sensitive data in query and path parameters.
Draft 3 - Published 2022-08-16
- Other small fixes.
Draft 2 - Published 2021-10-19
- Changing pagination description
Draft 1 - Published 2020-08-31
- Initial relase
Last modified 1mo ago