A API pública do ShortURL.bot é uma interface servidor a servidor para recursos do workspace. Ela compartilha direitos e contadores com o painel: chamadas não ignoram limites nem recebem cota separada.
1. Crie e limite uma chave
Crie em Configurações → Chaves de API. Disponível em todos os planos, pertence à assinatura e pode ser limitada por workspace. Guarde o segredo no servidor, nunca no navegador, app, repositório ou logs.
Use https://api.shorturl.bot/v1, Authorization: Bearer <api_key> e primeiro GET /workspaces.
2. Crie um link
curl -X POST "https://api.shorturl.bot/v1/workspaces/WORKSPACE_ID/links" -H "Authorization: Bearer $SHORTURL_API_KEY" -H "Content-Type: application/json" -d '{"targetUrl":"https://example.com/launch","backHalf":"launch","tags":["email"]}'Sucesso retorna 201. Omita domain para o padrão; 2s.gg serve apenas recursos antigos.
3. Planos e erros
- Todos: criação normal, tags, UTM e back-half dentro da cota.
- Go+: status e lotes de até 500 itens.
- Plus+: destino, agenda, expiração, redirecionamento e senha.
- Sistema: 800 requisições por IP/minuto além das cotas.
401 chave inválida; 403 acesso ou recurso negado; 429 cota ou taxa. Repita só falhas transitórias.
Próximo passo
Consulte a referência de desenvolvedores.