From ecf83d29a4fe547d2f38785f16a025d5d2fa8d66 Mon Sep 17 00:00:00 2001 From: Roman Lytvynenko Date: Wed, 24 Sep 2025 11:55:24 +0300 Subject: [PATCH] improve api docs: fix staging server path, add error responses --- src/CachetCoreServiceProvider.php | 2 +- src/Concerns/GuardsApiAbilities.php | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/src/CachetCoreServiceProvider.php b/src/CachetCoreServiceProvider.php index 9427fb77..d540baed 100644 --- a/src/CachetCoreServiceProvider.php +++ b/src/CachetCoreServiceProvider.php @@ -231,7 +231,7 @@ private function configureScramble(): void ->withDocumentTransformers(function (OpenApi $openApi) { $openApi->info->description = 'API documentation for Cachet, the open-source, self-hosted status page system.'; - $openApi->addServer(Server::make('https://v3.cachethq.io')->setDescription('The Cachet v3 demo server.')); + $openApi->addServer(Server::make('https://v3.cachethq.io/api')->setDescription('The Cachet v3 demo server.')); $openApi->secure(SecurityScheme::http('bearer')); }) ->withOperationTransformers(function (Operation $operation, RouteInfo $routeInfo) { diff --git a/src/Concerns/GuardsApiAbilities.php b/src/Concerns/GuardsApiAbilities.php index d11eb757..2887655f 100644 --- a/src/Concerns/GuardsApiAbilities.php +++ b/src/Concerns/GuardsApiAbilities.php @@ -9,6 +9,7 @@ trait GuardsApiAbilities { + /** @throws MissingAbilityException */ public function guard(string $ability): void { /** @var User $user */