API REST completa para encurtamento e gerenciamento de links. Autenticação via token, suporte a slugs personalizados e operações CRUD.
Todas as requisições devem incluir o header X-API-Token com seu token pessoal.
Exemplo:
X-API-Token: seu_token_aqui
Tokens são gerados automaticamente no seu perfil. A API precisa estar habilitada globalmente ou para seu usuário.
https://l4y.ovh/api?action=shorten
curl -X POST \
-H "Content-Type: application/json" \
-H "X-API-Token: SEU_TOKEN_AQUI" \
-d '{"url":"https://exemplo.com","slug":"meu-link"}' \
https://l4y.ovh/api?action=shorten{
"slug": "meu-link",
"short_url": "https://l4y.ovh/meu-link"
}{"error": "Slug já em uso"}
https://l4y.ovh/api?action=list
curl -H "X-API-Token: SEU_TOKEN_AQUI" \
https://l4y.ovh/api?action=list{
"links": [
{
"id": 123,
"slug": "abc123",
"original_url": "https://exemplo.com",
"short_url": "https://l4y.ovh/abc123",
"is_custom": false,
"user_id": 1,
"created_at": "2024-11-25 12:00:00",
"updated_at": "2024-11-25 12:00:00"
}
]
}
Admin: Use ?all=1 para listar todos os links do sistema.
https://l4y.ovh/api?action=update
curl -X PUT \
-H "Content-Type: application/json" \
-H "X-API-Token: SEU_TOKEN_AQUI" \
-d '{"id":123,"url":"https://novo.com","slug":"novo-slug"}' \
https://l4y.ovh/api?action=update{
"slug": "novo-slug",
"short_url": "https://l4y.ovh/novo-slug"
}
https://l4y.ovh/api?action=delete&id=123
curl -X DELETE \
-H "X-API-Token: SEU_TOKEN_AQUI" \
"https://l4y.ovh/api?action=delete&id=123"{"status": "ok"}