init openapi generator
This commit is contained in:
parent
f8f0aa171c
commit
9c821e2480
@ -5,8 +5,43 @@
|
|||||||
use OpenApi\Attributes as OA;
|
use OpenApi\Attributes as OA;
|
||||||
|
|
||||||
#[OA\Info(title: 'Coolify', version: '0.1')]
|
#[OA\Info(title: 'Coolify', version: '0.1')]
|
||||||
#[OA\Server(url: 'https://coolify.io/api/v1')]
|
#[OA\Server(url: 'https://app.coolify.io/api/v1')]
|
||||||
#[OA\SecurityScheme(type: 'http', scheme: 'bearer', bearerFormat: 'JWT', securityScheme: 'bearerAuth')]
|
#[OA\SecurityScheme(
|
||||||
|
type: 'http',
|
||||||
|
scheme: 'bearer',
|
||||||
|
securityScheme: 'bearerAuth',
|
||||||
|
description: 'Go to `Keys & Tokens` / `API tokens` and create a new token. Use the token as the bearer token.')]
|
||||||
|
#[OA\Components(
|
||||||
|
responses: [
|
||||||
|
new OA\Response(
|
||||||
|
response: 401,
|
||||||
|
description: 'Unauthenticated.',
|
||||||
|
content: new OA\JsonContent(
|
||||||
|
type: 'object',
|
||||||
|
properties: [
|
||||||
|
new OA\Property(property: 'message', type: 'string', example: 'Unauthenticated.'),
|
||||||
|
]
|
||||||
|
)),
|
||||||
|
new OA\Response(
|
||||||
|
response: 400,
|
||||||
|
description: 'Invalid token.',
|
||||||
|
content: new OA\JsonContent(
|
||||||
|
type: 'object',
|
||||||
|
properties: [
|
||||||
|
new OA\Property(property: 'message', type: 'string', example: 'Invalid token.'),
|
||||||
|
]
|
||||||
|
)),
|
||||||
|
new OA\Response(
|
||||||
|
response: 404,
|
||||||
|
description: 'Resource not found.',
|
||||||
|
content: new OA\JsonContent(
|
||||||
|
type: 'object',
|
||||||
|
properties: [
|
||||||
|
new OA\Property(property: 'message', type: 'string'),
|
||||||
|
]
|
||||||
|
)),
|
||||||
|
],
|
||||||
|
)]
|
||||||
class OpenApi
|
class OpenApi
|
||||||
{
|
{
|
||||||
// This class is used to generate OpenAPI documentation
|
// This class is used to generate OpenAPI documentation
|
||||||
|
187
app/Http/Controllers/Api/OtherController.php
Normal file
187
app/Http/Controllers/Api/OtherController.php
Normal file
@ -0,0 +1,187 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
namespace App\Http\Controllers\Api;
|
||||||
|
|
||||||
|
use App\Http\Controllers\Controller;
|
||||||
|
use App\Models\InstanceSettings;
|
||||||
|
use Illuminate\Http\Request;
|
||||||
|
use Illuminate\Support\Facades\Http;
|
||||||
|
use OpenApi\Attributes as OA;
|
||||||
|
|
||||||
|
class OtherController extends Controller
|
||||||
|
{
|
||||||
|
#[OA\Get(
|
||||||
|
summary: 'Version',
|
||||||
|
description: 'Get Coolify version.',
|
||||||
|
path: '/version',
|
||||||
|
security: [
|
||||||
|
['bearerAuth' => []],
|
||||||
|
],
|
||||||
|
responses: [
|
||||||
|
new OA\Response(
|
||||||
|
response: 200,
|
||||||
|
description: 'Returns the version of the application',
|
||||||
|
content: new OA\JsonContent(
|
||||||
|
type: 'string',
|
||||||
|
example: 'v4.0.0',
|
||||||
|
)),
|
||||||
|
new OA\Response(
|
||||||
|
response: 401,
|
||||||
|
ref: '#/components/responses/401',
|
||||||
|
),
|
||||||
|
new OA\Response(
|
||||||
|
response: 400,
|
||||||
|
ref: '#/components/responses/400',
|
||||||
|
),
|
||||||
|
]
|
||||||
|
)]
|
||||||
|
public function version(Request $request)
|
||||||
|
{
|
||||||
|
return response(config('version'));
|
||||||
|
}
|
||||||
|
|
||||||
|
#[OA\Get(
|
||||||
|
summary: 'Enable API',
|
||||||
|
description: 'Enable API (only with root permissions).',
|
||||||
|
path: '/enable',
|
||||||
|
security: [
|
||||||
|
['bearerAuth' => []],
|
||||||
|
],
|
||||||
|
responses: [
|
||||||
|
new OA\Response(
|
||||||
|
response: 200,
|
||||||
|
description: 'Enable API.',
|
||||||
|
content: new OA\JsonContent(
|
||||||
|
type: 'object',
|
||||||
|
properties: [
|
||||||
|
new OA\Property(property: 'message', type: 'string', example: 'API enabled.'),
|
||||||
|
]
|
||||||
|
)),
|
||||||
|
new OA\Response(
|
||||||
|
response: 403,
|
||||||
|
description: 'You are not allowed to enable the API.',
|
||||||
|
content: new OA\JsonContent(
|
||||||
|
type: 'object',
|
||||||
|
properties: [
|
||||||
|
new OA\Property(property: 'message', type: 'string', example: 'You are not allowed to enable the API.'),
|
||||||
|
]
|
||||||
|
)),
|
||||||
|
new OA\Response(
|
||||||
|
response: 401,
|
||||||
|
ref: '#/components/responses/401',
|
||||||
|
),
|
||||||
|
new OA\Response(
|
||||||
|
response: 400,
|
||||||
|
ref: '#/components/responses/400',
|
||||||
|
),
|
||||||
|
]
|
||||||
|
)]
|
||||||
|
public function enable_api(Request $request)
|
||||||
|
{
|
||||||
|
$teamId = getTeamIdFromToken();
|
||||||
|
if (is_null($teamId)) {
|
||||||
|
return invalidTokenResponse();
|
||||||
|
}
|
||||||
|
if ($teamId !== '0') {
|
||||||
|
return response()->json(['message' => 'You are not allowed to enable the API.'], 403);
|
||||||
|
}
|
||||||
|
$settings = InstanceSettings::get();
|
||||||
|
$settings->update(['is_api_enabled' => true]);
|
||||||
|
|
||||||
|
return response()->json(['message' => 'API enabled.'], 200);
|
||||||
|
}
|
||||||
|
|
||||||
|
#[OA\Get(
|
||||||
|
summary: 'Disable API',
|
||||||
|
description: 'Disable API (only with root permissions).',
|
||||||
|
path: '/disable',
|
||||||
|
security: [
|
||||||
|
['bearerAuth' => []],
|
||||||
|
],
|
||||||
|
responses: [
|
||||||
|
new OA\Response(
|
||||||
|
response: 200,
|
||||||
|
description: 'Disable API.',
|
||||||
|
content: new OA\JsonContent(
|
||||||
|
type: 'object',
|
||||||
|
properties: [
|
||||||
|
new OA\Property(property: 'message', type: 'string', example: 'API disabled.'),
|
||||||
|
]
|
||||||
|
)),
|
||||||
|
new OA\Response(
|
||||||
|
response: 403,
|
||||||
|
description: 'You are not allowed to disable the API.',
|
||||||
|
content: new OA\JsonContent(
|
||||||
|
type: 'object',
|
||||||
|
properties: [
|
||||||
|
new OA\Property(property: 'message', type: 'string', example: 'You are not allowed to disable the API.'),
|
||||||
|
]
|
||||||
|
)),
|
||||||
|
new OA\Response(
|
||||||
|
response: 401,
|
||||||
|
ref: '#/components/responses/401',
|
||||||
|
),
|
||||||
|
new OA\Response(
|
||||||
|
response: 400,
|
||||||
|
ref: '#/components/responses/400',
|
||||||
|
),
|
||||||
|
]
|
||||||
|
)]
|
||||||
|
public function disable_api(Request $request)
|
||||||
|
{
|
||||||
|
$teamId = getTeamIdFromToken();
|
||||||
|
if (is_null($teamId)) {
|
||||||
|
return invalidTokenResponse();
|
||||||
|
}
|
||||||
|
if ($teamId !== '0') {
|
||||||
|
return response()->json(['message' => 'You are not allowed to disable the API.'], 403);
|
||||||
|
}
|
||||||
|
$settings = InstanceSettings::get();
|
||||||
|
$settings->update(['is_api_enabled' => false]);
|
||||||
|
|
||||||
|
return response()->json(['message' => 'API disabled.'], 200);
|
||||||
|
}
|
||||||
|
|
||||||
|
public function feedback(Request $request)
|
||||||
|
{
|
||||||
|
$content = $request->input('content');
|
||||||
|
$webhook_url = config('coolify.feedback_discord_webhook');
|
||||||
|
if ($webhook_url) {
|
||||||
|
Http::post($webhook_url, [
|
||||||
|
'content' => $content,
|
||||||
|
]);
|
||||||
|
}
|
||||||
|
|
||||||
|
return response()->json(['message' => 'Feedback sent.'], 200);
|
||||||
|
}
|
||||||
|
|
||||||
|
#[OA\Get(
|
||||||
|
summary: 'Healthcheck',
|
||||||
|
description: 'Healthcheck endpoint.',
|
||||||
|
path: '/healthcheck',
|
||||||
|
security: [
|
||||||
|
['bearerAuth' => []],
|
||||||
|
],
|
||||||
|
responses: [
|
||||||
|
new OA\Response(
|
||||||
|
response: 200,
|
||||||
|
description: 'Healthcheck endpoint.',
|
||||||
|
content: new OA\JsonContent(
|
||||||
|
type: 'string',
|
||||||
|
example: 'OK',
|
||||||
|
)),
|
||||||
|
new OA\Response(
|
||||||
|
response: 401,
|
||||||
|
ref: '#/components/responses/401',
|
||||||
|
),
|
||||||
|
new OA\Response(
|
||||||
|
response: 400,
|
||||||
|
ref: '#/components/responses/400',
|
||||||
|
),
|
||||||
|
]
|
||||||
|
)]
|
||||||
|
public function healthcheck(Request $request)
|
||||||
|
{
|
||||||
|
return 'OK';
|
||||||
|
}
|
||||||
|
}
|
@ -28,9 +28,37 @@ private function removeSensitiveData($team)
|
|||||||
return serializeApiResponse($team);
|
return serializeApiResponse($team);
|
||||||
}
|
}
|
||||||
|
|
||||||
#[OA\Get(path: '/teams')]
|
#[OA\Get(
|
||||||
#[OA\Response(response: '200', description: 'List of teams')]
|
summary: 'List',
|
||||||
#[OA\Response(response: '401', description: 'Unauthorized')]
|
description: 'Get all teams.',
|
||||||
|
path: '/teams',
|
||||||
|
security: [
|
||||||
|
['bearerAuth' => []],
|
||||||
|
],
|
||||||
|
tags: ['Teams'],
|
||||||
|
responses: [
|
||||||
|
new OA\Response(
|
||||||
|
response: 200,
|
||||||
|
description: 'List of teams.',
|
||||||
|
content: [
|
||||||
|
new OA\MediaType(
|
||||||
|
mediaType: 'application/json',
|
||||||
|
schema: new OA\Schema(
|
||||||
|
type: 'array',
|
||||||
|
items: new OA\Items(ref: '#/components/schemas/Team')
|
||||||
|
)
|
||||||
|
),
|
||||||
|
]),
|
||||||
|
new OA\Response(
|
||||||
|
response: 401,
|
||||||
|
ref: '#/components/responses/401',
|
||||||
|
),
|
||||||
|
new OA\Response(
|
||||||
|
response: 400,
|
||||||
|
ref: '#/components/responses/400',
|
||||||
|
),
|
||||||
|
]
|
||||||
|
)]
|
||||||
public function teams(Request $request)
|
public function teams(Request $request)
|
||||||
{
|
{
|
||||||
$teamId = getTeamIdFromToken();
|
$teamId = getTeamIdFromToken();
|
||||||
@ -47,32 +75,36 @@ public function teams(Request $request)
|
|||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
#[OA\Get(path: '/teams/{id}')]
|
#[OA\Get(
|
||||||
#[OA\Response(
|
summary: 'Get',
|
||||||
response: 401,
|
description: 'Get team by TeamId.',
|
||||||
description: 'Unauthorized',
|
path: '/teams/{id}',
|
||||||
content: new OA\JsonContent(
|
security: [
|
||||||
type: 'object',
|
['bearerAuth' => []],
|
||||||
properties: [
|
],
|
||||||
new OA\Property(property: 'message', type: 'string', example: 'Unauthenticated.'),
|
tags: ['Teams'],
|
||||||
]
|
parameters: [
|
||||||
)
|
new OA\Parameter(name: 'id', in: 'path', required: true, description: 'Team ID', schema: new OA\Schema(type: 'integer')),
|
||||||
)]
|
],
|
||||||
#[OA\Response(response: '404', description: 'Team not found')]
|
responses: [
|
||||||
#[OA\Parameter(name: 'id', in: 'path', required: true, description: 'Team ID', schema: new OA\Schema(type: 'integer'))]
|
new OA\Response(
|
||||||
// response 200 with team model
|
response: 200,
|
||||||
#[OA\Response(
|
description: 'List of teams.',
|
||||||
response: 200,
|
content: new OA\JsonContent(ref: '#/components/schemas/Team')
|
||||||
description: 'Team model',
|
),
|
||||||
content: new OA\JsonContent(
|
new OA\Response(
|
||||||
type: 'object',
|
response: 401,
|
||||||
properties: [
|
ref: '#/components/responses/401',
|
||||||
new OA\Property(property: 'id', type: 'integer', example: 1),
|
),
|
||||||
new OA\Property(property: 'name', type: 'string', example: 'Team 1'),
|
new OA\Response(
|
||||||
new OA\Property(property: 'created_at', type: 'string', format: 'date-time', example: '2021-10-10T10:00:00Z'),
|
response: 400,
|
||||||
new OA\Property(property: 'updated_at', type: 'string', format: 'date-time', example: '2021-10-10T10:00:00Z'),
|
ref: '#/components/responses/400',
|
||||||
]
|
),
|
||||||
)
|
new OA\Response(
|
||||||
|
response: 404,
|
||||||
|
ref: '#/components/responses/404',
|
||||||
|
),
|
||||||
|
]
|
||||||
)]
|
)]
|
||||||
public function team_by_id(Request $request)
|
public function team_by_id(Request $request)
|
||||||
{
|
{
|
||||||
|
@ -7,7 +7,60 @@
|
|||||||
use Illuminate\Database\Eloquent\Casts\Attribute;
|
use Illuminate\Database\Eloquent\Casts\Attribute;
|
||||||
use Illuminate\Database\Eloquent\Model;
|
use Illuminate\Database\Eloquent\Model;
|
||||||
use Illuminate\Notifications\Notifiable;
|
use Illuminate\Notifications\Notifiable;
|
||||||
|
use OpenApi\Attributes as OA;
|
||||||
|
|
||||||
|
#[OA\Schema(
|
||||||
|
description: 'Team model',
|
||||||
|
type: 'object',
|
||||||
|
properties: [
|
||||||
|
'id' => ['type' => 'integer', 'description' => 'The unique identifier of the team.'],
|
||||||
|
'name' => ['type' => 'string', 'description' => 'The name of the team.'],
|
||||||
|
'description' => ['type' => 'string', 'description' => 'The description of the team.'],
|
||||||
|
'personal_team' => ['type' => 'boolean', 'description' => 'Whether the team is personal or not.'],
|
||||||
|
'created_at' => ['type' => 'string', 'description' => 'The date and time the team was created.'],
|
||||||
|
'updated_at' => ['type' => 'string', 'description' => 'The date and time the team was last updated.'],
|
||||||
|
'smtp_enabled' => ['type' => 'boolean', 'description' => 'Whether SMTP is enabled or not.'],
|
||||||
|
'smtp_from_address' => ['type' => 'string', 'description' => 'The email address to send emails from.'],
|
||||||
|
'smtp_from_name' => ['type' => 'string', 'description' => 'The name to send emails from.'],
|
||||||
|
'smtp_recipients' => ['type' => 'string', 'description' => 'The email addresses to send emails to.'],
|
||||||
|
'smtp_host' => ['type' => 'string', 'description' => 'The SMTP host.'],
|
||||||
|
'smtp_port' => ['type' => 'string', 'description' => 'The SMTP port.'],
|
||||||
|
'smtp_encryption' => ['type' => 'string', 'description' => 'The SMTP encryption.'],
|
||||||
|
'smtp_username' => ['type' => 'string', 'description' => 'The SMTP username.'],
|
||||||
|
'smtp_password' => ['type' => 'string', 'description' => 'The SMTP password.'],
|
||||||
|
'smtp_timeout' => ['type' => 'string', 'description' => 'The SMTP timeout.'],
|
||||||
|
'smtp_notifications_test' => ['type' => 'boolean', 'description' => 'Whether to send test notifications via SMTP.'],
|
||||||
|
'smtp_notifications_deployments' => ['type' => 'boolean', 'description' => 'Whether to send deployment notifications via SMTP.'],
|
||||||
|
'smtp_notifications_status_changes' => ['type' => 'boolean', 'description' => 'Whether to send status change notifications via SMTP.'],
|
||||||
|
'smtp_notifications_scheduled_tasks' => ['type' => 'boolean', 'description' => 'Whether to send scheduled task notifications via SMTP.'],
|
||||||
|
'smtp_notifications_database_backups' => ['type' => 'boolean', 'description' => 'Whether to send database backup notifications via SMTP.'],
|
||||||
|
'discord_enabled' => ['type' => 'boolean', 'description' => 'Whether Discord is enabled or not.'],
|
||||||
|
'discord_webhook_url' => ['type' => 'string', 'description' => 'The Discord webhook URL.'],
|
||||||
|
'discord_notifications_test' => ['type' => 'boolean', 'description' => 'Whether to send test notifications via Discord.'],
|
||||||
|
'discord_notifications_deployments' => ['type' => 'boolean', 'description' => 'Whether to send deployment notifications via Discord.'],
|
||||||
|
'discord_notifications_status_changes' => ['type' => 'boolean', 'description' => 'Whether to send status change notifications via Discord.'],
|
||||||
|
'discord_notifications_database_backups' => ['type' => 'boolean', 'description' => 'Whether to send database backup notifications via Discord.'],
|
||||||
|
'discord_notifications_scheduled_tasks' => ['type' => 'boolean', 'description' => 'Whether to send scheduled task notifications via Discord.'],
|
||||||
|
'show_boarding' => ['type' => 'boolean', 'description' => 'Whether to show the boarding screen or not.'],
|
||||||
|
'resend_enabled' => ['type' => 'boolean', 'description' => 'Whether to enable resending or not.'],
|
||||||
|
'resend_api_key' => ['type' => 'string', 'description' => 'The resending API key.'],
|
||||||
|
'use_instance_email_settings' => ['type' => 'boolean', 'description' => 'Whether to use instance email settings or not.'],
|
||||||
|
'telegram_enabled' => ['type' => 'boolean', 'description' => 'Whether Telegram is enabled or not.'],
|
||||||
|
'telegram_token' => ['type' => 'string', 'description' => 'The Telegram token.'],
|
||||||
|
'telegram_chat_id' => ['type' => 'string', 'description' => 'The Telegram chat ID.'],
|
||||||
|
'telegram_notifications_test' => ['type' => 'boolean', 'description' => 'Whether to send test notifications via Telegram.'],
|
||||||
|
'telegram_notifications_deployments' => ['type' => 'boolean', 'description' => 'Whether to send deployment notifications via Telegram.'],
|
||||||
|
'telegram_notifications_status_changes' => ['type' => 'boolean', 'description' => 'Whether to send status change notifications via Telegram.'],
|
||||||
|
'telegram_notifications_database_backups' => ['type' => 'boolean', 'description' => 'Whether to send database backup notifications via Telegram.'],
|
||||||
|
'telegram_notifications_test_message_thread_id' => ['type' => 'string', 'description' => 'The Telegram test message thread ID.'],
|
||||||
|
'telegram_notifications_deployments_message_thread_id' => ['type' => 'string', 'description' => 'The Telegram deployment message thread ID.'],
|
||||||
|
'telegram_notifications_status_changes_message_thread_id' => ['type' => 'string', 'description' => 'The Telegram status change message thread ID.'],
|
||||||
|
'telegram_notifications_database_backups_message_thread_id' => ['type' => 'string', 'description' => 'The Telegram database backup message thread ID.'],
|
||||||
|
'custom_server_limit' => ['type' => 'string', 'description' => 'The custom server limit.'],
|
||||||
|
'telegram_notifications_scheduled_tasks' => ['type' => 'boolean', 'description' => 'Whether to send scheduled task notifications via Telegram.'],
|
||||||
|
'telegram_notifications_scheduled_tasks_thread_id' => ['type' => 'string', 'description' => 'The Telegram scheduled task message thread ID.'],
|
||||||
|
]
|
||||||
|
)]
|
||||||
class Team extends Model implements SendsDiscord, SendsEmail
|
class Team extends Model implements SendsDiscord, SendsEmail
|
||||||
{
|
{
|
||||||
use Notifiable;
|
use Notifiable;
|
||||||
|
330
openapi.yaml
330
openapi.yaml
@ -4,18 +4,135 @@ info:
|
|||||||
version: '0.1'
|
version: '0.1'
|
||||||
servers:
|
servers:
|
||||||
-
|
-
|
||||||
url: 'https://coolify.io/api/v1'
|
url: 'https://app.coolify.io/api/v1'
|
||||||
paths:
|
paths:
|
||||||
|
/version:
|
||||||
|
get:
|
||||||
|
summary: Version
|
||||||
|
description: 'Get Coolify version.'
|
||||||
|
operationId: 187b37139844731110757711ee71c215
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: 'Returns the version of the application'
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
example: v4.0.0
|
||||||
|
'401':
|
||||||
|
$ref: '#/components/responses/401'
|
||||||
|
'400':
|
||||||
|
$ref: '#/components/responses/400'
|
||||||
|
security:
|
||||||
|
-
|
||||||
|
bearerAuth: []
|
||||||
|
/enable:
|
||||||
|
get:
|
||||||
|
summary: 'Enable API'
|
||||||
|
description: 'Enable API (only with root permissions).'
|
||||||
|
operationId: 595019bae03d08277def667609779ff3
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: 'Enable API.'
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
properties:
|
||||||
|
message: { type: string, example: 'API enabled.' }
|
||||||
|
type: object
|
||||||
|
'403':
|
||||||
|
description: 'You are not allowed to enable the API.'
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
properties:
|
||||||
|
message: { type: string, example: 'You are not allowed to enable the API.' }
|
||||||
|
type: object
|
||||||
|
'401':
|
||||||
|
$ref: '#/components/responses/401'
|
||||||
|
'400':
|
||||||
|
$ref: '#/components/responses/400'
|
||||||
|
security:
|
||||||
|
-
|
||||||
|
bearerAuth: []
|
||||||
|
/disable:
|
||||||
|
get:
|
||||||
|
summary: 'Disable API'
|
||||||
|
description: 'Disable API (only with root permissions).'
|
||||||
|
operationId: 50e2486a2d196a996b24a284a283bcdb
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: 'Disable API.'
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
properties:
|
||||||
|
message: { type: string, example: 'API disabled.' }
|
||||||
|
type: object
|
||||||
|
'403':
|
||||||
|
description: 'You are not allowed to disable the API.'
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
properties:
|
||||||
|
message: { type: string, example: 'You are not allowed to disable the API.' }
|
||||||
|
type: object
|
||||||
|
'401':
|
||||||
|
$ref: '#/components/responses/401'
|
||||||
|
'400':
|
||||||
|
$ref: '#/components/responses/400'
|
||||||
|
security:
|
||||||
|
-
|
||||||
|
bearerAuth: []
|
||||||
|
/healthcheck:
|
||||||
|
get:
|
||||||
|
summary: Healthcheck
|
||||||
|
description: 'Healthcheck endpoint.'
|
||||||
|
operationId: 64db893135e686704bb88c3c238022c1
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: 'Healthcheck endpoint.'
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
example: OK
|
||||||
|
'401':
|
||||||
|
$ref: '#/components/responses/401'
|
||||||
|
'400':
|
||||||
|
$ref: '#/components/responses/400'
|
||||||
|
security:
|
||||||
|
-
|
||||||
|
bearerAuth: []
|
||||||
/teams:
|
/teams:
|
||||||
get:
|
get:
|
||||||
|
tags:
|
||||||
|
- Teams
|
||||||
|
summary: List
|
||||||
|
description: 'Get all teams.'
|
||||||
operationId: f9c530b5b25df9601cb87d6a58646f0a
|
operationId: f9c530b5b25df9601cb87d6a58646f0a
|
||||||
responses:
|
responses:
|
||||||
'200':
|
'200':
|
||||||
description: 'List of teams'
|
description: 'List of teams.'
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
$ref: '#/components/schemas/Team'
|
||||||
'401':
|
'401':
|
||||||
description: Unauthorized
|
$ref: '#/components/responses/401'
|
||||||
|
'400':
|
||||||
|
$ref: '#/components/responses/400'
|
||||||
|
security:
|
||||||
|
-
|
||||||
|
bearerAuth: []
|
||||||
'/teams/{id}':
|
'/teams/{id}':
|
||||||
get:
|
get:
|
||||||
|
tags:
|
||||||
|
- Teams
|
||||||
|
summary: Get
|
||||||
|
description: 'Get team by TeamId.'
|
||||||
operationId: ac57ff546c002032cef44602c46a4e76
|
operationId: ac57ff546c002032cef44602c46a4e76
|
||||||
parameters:
|
parameters:
|
||||||
-
|
-
|
||||||
@ -26,30 +143,201 @@ paths:
|
|||||||
schema:
|
schema:
|
||||||
type: integer
|
type: integer
|
||||||
responses:
|
responses:
|
||||||
'401':
|
|
||||||
description: Unauthorized
|
|
||||||
content:
|
|
||||||
application/json:
|
|
||||||
schema:
|
|
||||||
properties:
|
|
||||||
message: { type: string, example: Unauthenticated. }
|
|
||||||
type: object
|
|
||||||
'404':
|
|
||||||
description: 'Team not found'
|
|
||||||
'200':
|
'200':
|
||||||
description: 'Team model'
|
description: 'List of teams.'
|
||||||
content:
|
content:
|
||||||
application/json:
|
application/json:
|
||||||
schema:
|
schema:
|
||||||
properties:
|
$ref: '#/components/schemas/Team'
|
||||||
id: { type: integer, example: 1 }
|
'401':
|
||||||
name: { type: string, example: 'Team 1' }
|
$ref: '#/components/responses/401'
|
||||||
created_at: { type: string, format: date-time, example: '2021-10-10T10:00:00Z' }
|
'400':
|
||||||
updated_at: { type: string, format: date-time, example: '2021-10-10T10:00:00Z' }
|
$ref: '#/components/responses/400'
|
||||||
type: object
|
'404':
|
||||||
|
$ref: '#/components/responses/404'
|
||||||
|
security:
|
||||||
|
-
|
||||||
|
bearerAuth: []
|
||||||
components:
|
components:
|
||||||
|
schemas:
|
||||||
|
Team:
|
||||||
|
description: 'Team model'
|
||||||
|
properties:
|
||||||
|
id:
|
||||||
|
type: integer
|
||||||
|
description: 'The unique identifier of the team.'
|
||||||
|
name:
|
||||||
|
type: string
|
||||||
|
description: 'The name of the team.'
|
||||||
|
description:
|
||||||
|
type: string
|
||||||
|
description: 'The description of the team.'
|
||||||
|
personal_team:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether the team is personal or not.'
|
||||||
|
created_at:
|
||||||
|
type: string
|
||||||
|
description: 'The date and time the team was created.'
|
||||||
|
updated_at:
|
||||||
|
type: string
|
||||||
|
description: 'The date and time the team was last updated.'
|
||||||
|
smtp_enabled:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether SMTP is enabled or not.'
|
||||||
|
smtp_from_address:
|
||||||
|
type: string
|
||||||
|
description: 'The email address to send emails from.'
|
||||||
|
smtp_from_name:
|
||||||
|
type: string
|
||||||
|
description: 'The name to send emails from.'
|
||||||
|
smtp_recipients:
|
||||||
|
type: string
|
||||||
|
description: 'The email addresses to send emails to.'
|
||||||
|
smtp_host:
|
||||||
|
type: string
|
||||||
|
description: 'The SMTP host.'
|
||||||
|
smtp_port:
|
||||||
|
type: string
|
||||||
|
description: 'The SMTP port.'
|
||||||
|
smtp_encryption:
|
||||||
|
type: string
|
||||||
|
description: 'The SMTP encryption.'
|
||||||
|
smtp_username:
|
||||||
|
type: string
|
||||||
|
description: 'The SMTP username.'
|
||||||
|
smtp_password:
|
||||||
|
type: string
|
||||||
|
description: 'The SMTP password.'
|
||||||
|
smtp_timeout:
|
||||||
|
type: string
|
||||||
|
description: 'The SMTP timeout.'
|
||||||
|
smtp_notifications_test:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to send test notifications via SMTP.'
|
||||||
|
smtp_notifications_deployments:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to send deployment notifications via SMTP.'
|
||||||
|
smtp_notifications_status_changes:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to send status change notifications via SMTP.'
|
||||||
|
smtp_notifications_scheduled_tasks:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to send scheduled task notifications via SMTP.'
|
||||||
|
smtp_notifications_database_backups:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to send database backup notifications via SMTP.'
|
||||||
|
discord_enabled:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether Discord is enabled or not.'
|
||||||
|
discord_webhook_url:
|
||||||
|
type: string
|
||||||
|
description: 'The Discord webhook URL.'
|
||||||
|
discord_notifications_test:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to send test notifications via Discord.'
|
||||||
|
discord_notifications_deployments:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to send deployment notifications via Discord.'
|
||||||
|
discord_notifications_status_changes:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to send status change notifications via Discord.'
|
||||||
|
discord_notifications_database_backups:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to send database backup notifications via Discord.'
|
||||||
|
discord_notifications_scheduled_tasks:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to send scheduled task notifications via Discord.'
|
||||||
|
show_boarding:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to show the boarding screen or not.'
|
||||||
|
resend_enabled:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to enable resending or not.'
|
||||||
|
resend_api_key:
|
||||||
|
type: string
|
||||||
|
description: 'The resending API key.'
|
||||||
|
use_instance_email_settings:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to use instance email settings or not.'
|
||||||
|
telegram_enabled:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether Telegram is enabled or not.'
|
||||||
|
telegram_token:
|
||||||
|
type: string
|
||||||
|
description: 'The Telegram token.'
|
||||||
|
telegram_chat_id:
|
||||||
|
type: string
|
||||||
|
description: 'The Telegram chat ID.'
|
||||||
|
telegram_notifications_test:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to send test notifications via Telegram.'
|
||||||
|
telegram_notifications_deployments:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to send deployment notifications via Telegram.'
|
||||||
|
telegram_notifications_status_changes:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to send status change notifications via Telegram.'
|
||||||
|
telegram_notifications_database_backups:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to send database backup notifications via Telegram.'
|
||||||
|
telegram_notifications_test_message_thread_id:
|
||||||
|
type: string
|
||||||
|
description: 'The Telegram test message thread ID.'
|
||||||
|
telegram_notifications_deployments_message_thread_id:
|
||||||
|
type: string
|
||||||
|
description: 'The Telegram deployment message thread ID.'
|
||||||
|
telegram_notifications_status_changes_message_thread_id:
|
||||||
|
type: string
|
||||||
|
description: 'The Telegram status change message thread ID.'
|
||||||
|
telegram_notifications_database_backups_message_thread_id:
|
||||||
|
type: string
|
||||||
|
description: 'The Telegram database backup message thread ID.'
|
||||||
|
custom_server_limit:
|
||||||
|
type: string
|
||||||
|
description: 'The custom server limit.'
|
||||||
|
telegram_notifications_scheduled_tasks:
|
||||||
|
type: boolean
|
||||||
|
description: 'Whether to send scheduled task notifications via Telegram.'
|
||||||
|
telegram_notifications_scheduled_tasks_thread_id:
|
||||||
|
type: string
|
||||||
|
description: 'The Telegram scheduled task message thread ID.'
|
||||||
|
type: object
|
||||||
|
responses:
|
||||||
|
'401':
|
||||||
|
description: Unauthenticated.
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
properties:
|
||||||
|
message:
|
||||||
|
type: string
|
||||||
|
example: Unauthenticated.
|
||||||
|
type: object
|
||||||
|
'400':
|
||||||
|
description: 'Invalid token.'
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
properties:
|
||||||
|
message:
|
||||||
|
type: string
|
||||||
|
example: 'Invalid token.'
|
||||||
|
type: object
|
||||||
|
'404':
|
||||||
|
description: 'Resource not found.'
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
properties:
|
||||||
|
message:
|
||||||
|
type: string
|
||||||
|
type: object
|
||||||
securitySchemes:
|
securitySchemes:
|
||||||
bearerAuth:
|
bearerAuth:
|
||||||
type: http
|
type: http
|
||||||
bearerFormat: JWT
|
description: 'Go to `Keys & Tokens` / `API tokens` and create a new token. Use the token as the bearer token.'
|
||||||
scheme: bearer
|
scheme: bearer
|
||||||
|
tags:
|
||||||
|
-
|
||||||
|
name: Teams
|
||||||
|
description: Teams
|
||||||
|
@ -3,7 +3,7 @@
|
|||||||
use App\Http\Controllers\Api\ApplicationsController;
|
use App\Http\Controllers\Api\ApplicationsController;
|
||||||
use App\Http\Controllers\Api\DatabasesController;
|
use App\Http\Controllers\Api\DatabasesController;
|
||||||
use App\Http\Controllers\Api\DeployController;
|
use App\Http\Controllers\Api\DeployController;
|
||||||
use App\Http\Controllers\Api\EnvironmentVariablesController;
|
use App\Http\Controllers\Api\OtherController;
|
||||||
use App\Http\Controllers\Api\ProjectController;
|
use App\Http\Controllers\Api\ProjectController;
|
||||||
use App\Http\Controllers\Api\ResourcesController;
|
use App\Http\Controllers\Api\ResourcesController;
|
||||||
use App\Http\Controllers\Api\SecurityController;
|
use App\Http\Controllers\Api\SecurityController;
|
||||||
@ -13,65 +13,23 @@
|
|||||||
use App\Http\Middleware\ApiAllowed;
|
use App\Http\Middleware\ApiAllowed;
|
||||||
use App\Http\Middleware\IgnoreReadOnlyApiToken;
|
use App\Http\Middleware\IgnoreReadOnlyApiToken;
|
||||||
use App\Http\Middleware\OnlyRootApiToken;
|
use App\Http\Middleware\OnlyRootApiToken;
|
||||||
use App\Models\InstanceSettings;
|
|
||||||
use Illuminate\Http\Request;
|
|
||||||
use Illuminate\Support\Facades\Http;
|
|
||||||
use Illuminate\Support\Facades\Route;
|
use Illuminate\Support\Facades\Route;
|
||||||
|
|
||||||
Route::get('/health', function () {
|
Route::get('/health', [OtherController::class, 'healthcheck']);
|
||||||
return 'OK';
|
Route::post('/feedback', [OtherController::class, 'feedback']);
|
||||||
});
|
|
||||||
Route::post('/feedback', function (Request $request) {
|
|
||||||
$content = $request->input('content');
|
|
||||||
$webhook_url = config('coolify.feedback_discord_webhook');
|
|
||||||
if ($webhook_url) {
|
|
||||||
Http::post($webhook_url, [
|
|
||||||
'content' => $content,
|
|
||||||
]);
|
|
||||||
}
|
|
||||||
|
|
||||||
return response()->json(['success' => true, 'message' => 'Feedback sent.'], 200);
|
|
||||||
});
|
|
||||||
|
|
||||||
Route::group([
|
Route::group([
|
||||||
'middleware' => ['auth:sanctum', OnlyRootApiToken::class],
|
'middleware' => ['auth:sanctum', OnlyRootApiToken::class],
|
||||||
'prefix' => 'v1',
|
'prefix' => 'v1',
|
||||||
], function () {
|
], function () {
|
||||||
Route::get('/enable', function () {
|
Route::get('/enable', [OtherController::class, 'enable_api']);
|
||||||
$teamId = getTeamIdFromToken();
|
Route::get('/disable', [OtherController::class, 'disable_api']);
|
||||||
if (is_null($teamId)) {
|
|
||||||
return invalidTokenResponse();
|
|
||||||
}
|
|
||||||
if ($teamId !== '0') {
|
|
||||||
return response()->json(['message' => 'You are not allowed to enable the API.'], 403);
|
|
||||||
}
|
|
||||||
$settings = InstanceSettings::get();
|
|
||||||
$settings->update(['is_api_enabled' => true]);
|
|
||||||
|
|
||||||
return response()->json(['success' => true, 'message' => 'API enabled.'], 200);
|
|
||||||
});
|
|
||||||
Route::get('/disable', function () {
|
|
||||||
$teamId = getTeamIdFromToken();
|
|
||||||
if (is_null($teamId)) {
|
|
||||||
return invalidTokenResponse();
|
|
||||||
}
|
|
||||||
if ($teamId !== '0') {
|
|
||||||
return response()->json(['message' => 'You are not allowed to disable the API.'], 403);
|
|
||||||
}
|
|
||||||
$settings = InstanceSettings::get();
|
|
||||||
$settings->update(['is_api_enabled' => false]);
|
|
||||||
|
|
||||||
return response()->json(['success' => true, 'message' => 'API disabled.'], 200);
|
|
||||||
});
|
|
||||||
|
|
||||||
});
|
});
|
||||||
Route::group([
|
Route::group([
|
||||||
'middleware' => ['auth:sanctum', ApiAllowed::class],
|
'middleware' => ['auth:sanctum', ApiAllowed::class],
|
||||||
'prefix' => 'v1',
|
'prefix' => 'v1',
|
||||||
], function () {
|
], function () {
|
||||||
Route::get('/version', function () {
|
Route::get('/version', [OtherController::class, 'version']);
|
||||||
return response(config('version'));
|
|
||||||
});
|
|
||||||
|
|
||||||
Route::get('/teams', [TeamController::class, 'teams']);
|
Route::get('/teams', [TeamController::class, 'teams']);
|
||||||
Route::get('/teams/current', [TeamController::class, 'current_team']);
|
Route::get('/teams/current', [TeamController::class, 'current_team']);
|
||||||
|
Loading…
Reference in New Issue
Block a user