Endpoints
Apps
CRUD de apps (aplicações registradas).
Aplicações registradas (ex.: app1, app2). Base path: /api/apps ·
autenticação de usuário.
| Método | Rota | Scope | Resource | Sucesso |
|---|---|---|---|---|
POST | /api/apps | create | resource:apps | 201 |
GET | /api/apps | read | resource:apps | 200 |
GET | /api/apps/:id | read | resource:apps_id | 200 |
PUT | /api/apps/:id | update | resource:apps_id | 200 |
DELETE | /api/apps/:id | delete | resource:apps_id | 204 |
Criar app
POST /api/apps
Corpo
| Campo | Tipo | Obrigatório | Regras |
|---|---|---|---|
name | string | sim | mín. 1, único |
curl -X POST http://localhost:3000/api/apps \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "name": "App Exemplo" }'201 Created
{
"id": "a1b2c3d4-e5f6-4789-a123-456789abcdef",
"name": "App Exemplo"
}Listar apps
GET /api/apps — lista paginada (page, limit).
Obter app por id
GET /api/apps/:id — 404 se não existir.
Editar app
PUT /api/apps/:id — corpo com name opcional (mín. 1). Retorna 200.
Remover app
DELETE /api/apps/:id — retorna 204 No Content.