API MODZ SHORT — v1
Base URL: https://go.modz.ink/api/v1
Autenticação
Todos os pedidos precisam de:
Authorization: Bearer modz_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Crie a sua chave em /dashboard/api-keys.
Criar link
POST /api/v1/links
Content-Type: application/json
Authorization: Bearer modz_...
{
"url": "https://example.com/pagina",
"custom_alias": "promo",
"title": "Promoção"
}
Resposta 201:
{
"success": true,
"short_url": "http://127.0.0.1:8080/promo",
"code": "promo",
"id": 12,
"url": "https://example.com/pagina"
}
Listar links
GET /api/v1/links?limit=50&offset=0
Detalhes de um link
GET /api/v1/links/{id}
Estatísticas de um link
GET /api/v1/links/{id}/stats
Apagar link
DELETE /api/v1/links/{id}
Códigos de erro
- 400 — JSON inválido ou corpo vazio
- 401 — chave ausente/inválida/revogada
- 404 — recurso não encontrado
- 422 — URL inválida, alias duplicado, etc.
- 429 — limite de 60 pedidos/min por chave excedido