L'API pubblica è un'interfaccia server-to-server per le risorse del workspace. Condivide diritti e contatori con la dashboard: nessun aggiramento e nessuna quota separata.
1. Crea e limita una chiave
Creala in Impostazioni → Chiavi API. È disponibile in tutti i piani, appartiene all'abbonamento e può essere limitata per workspace. Conserva il segreto solo lato server.
Usa https://api.shorturl.bot/v1, Authorization: Bearer <api_key> e prima GET /workspaces.
2. Crea un 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"]}'Il successo restituisce 201. Senza domain vale il predefinito; 2s.gg è solo per asset esistenti.
3. Piani ed errori
- Tutti: creazione, tag, UTM e back-half nella quota.
- Go+: stato e batch fino a 500 elementi.
- Plus+: destinazione, piano, scadenza, redirect e password.
- Sistema: 800 richieste/IP/minuto.
401 chiave non valida; 403 accesso negato; 429 limite. Ripeti solo errori transitori.
Prossimo passo
Consulta il riferimento sviluppatori.