De openbare API is een server-naar-serverinterface voor workspaceresources. Zij deelt rechten en tellers met het dashboard: geen omzeiling en geen apart quotum.
1. Maak en beperk een sleutel
Maak deze in Instellingen → API-sleutels. Beschikbaar op elk abonnement, gekoppeld aan abonnement en workspaces. Bewaar het geheim alleen server-side.
Gebruik https://api.shorturl.bot/v1, Authorization: Bearer <api_key> en eerst GET /workspaces.
2. Maak een 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"]}'Succes geeft 201. Zonder domain geldt de standaard; 2s.gg is alleen voor bestaande assets.
3. Abonnementen en fouten
- Alle: creatie, tags, UTM en back-half binnen quotum.
- Go+: status en batches tot 500 items.
- Plus+: doel, planning, afloop, redirect en wachtwoord.
- Systeem: 800 verzoeken/IP/minuut.
401 sleutel ongeldig; 403 toegang geweigerd; 429 limiet. Herhaal alleen tijdelijke fouten.
Verder
Bekijk de ontwikkelaarsreferentie.