01Documented with OpenAPI
Each endpoint is described in the OpenAPI Specification, a vendor-neutral format for describing HTTP APIs that tools can read and test [1].
02Correct HTTP semantics
Methods, status codes and caching follow RFC 9110, the current HTTP semantics standard [2]. Rate limits return 429 Too Many Requests, defined in RFC 6585 [3].
03API security
Access control and data exposure are reviewed against the OWASP API Security Top 10, where broken object-level authorisation is the top risk [4].
References
- [1]OpenAPI Specification · OpenAPI Initiativespec.openapis.org/oas/latest.html
- [2]RFC 9110: HTTP Semantics · IETF, 2022www.rfc-editor.org/rfc/rfc9110
- [3]RFC 6585: Additional HTTP Status Codes (429) · IETF, 2012www.rfc-editor.org/rfc/rfc6585
- [4]OWASP API Security Top 10 · OWASP Foundationowasp.org/API-Security/