core
core copied to clipboard
Improve API documentation: fix for demo server path, added `403` error responses, improved schema for paginated responses
This PR brings a few improvements to API docs.
-
By upgrading Scramble and Scramble PRO to
0.12.35and0.7.18, Cachet API docs will have a more accurate pagination information schema (links are optional, but when present – they'll be strings). -
Fixed demo server path (was
https://v3.cachethq.iobut the correct one ishttps://v3.cachethq.io/api). -
Added
/** @throws MissingAbilityException */annotation to theGuardsApiAbilitiestrait. This, in turn, improved documentation of endpoints that use this trait and now include a403response.
Altogether, this makes the documentation more accurate and consumers of this API happier 🫶