Die öffentliche API ist eine Server-zu-Server-Schnittstelle für Workspace-Ressourcen. Sie nutzt dieselben Rechte und Zähler wie das Dashboard: keine Umgehung und kein separates Kontingent.
1. Schlüssel erstellen und begrenzen
Erstellen Sie ihn unter Einstellungen → API-Schlüssel. Er ist in allen Tarifen verfügbar, gehört zum Abonnement und kann auf Workspaces beschränkt werden. Secret nur serverseitig speichern.
Nutzen Sie https://api.shorturl.bot/v1, Authorization: Bearer <api_key> und zuerst GET /workspaces.
2. Link erstellen
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"]}'Erfolg liefert 201. Ohne domain gilt der Standard; 2s.gg ist nur für Altbestände.
3. Tarife und Fehler
- Alle: Erstellung, Tags, UTM und Back-Half im Kontingent.
- Go+: Status und bis zu 500 Elemente je Batch.
- Plus+: Ziel, Zeitplan, Ablauf, Redirect und Passwort.
- System: 800 Requests/IP/Minute zusätzlich.
401 Schlüssel ungültig; 403 Zugriff/Funktion verweigert; 429 Grenze. Nur temporäre Fehler wiederholen.
Weiter
Siehe Entwicklerreferenz.