Publiczne API to interfejs serwer-serwer dla zasobów workspace. Dzieli uprawnienia i liczniki z panelem: nie omija limitów i nie ma osobnej puli.
1. Utwórz i ogranicz klucz
Utwórz go w Ustawienia → Klucze API. Jest we wszystkich planach, należy do subskrypcji i może być ograniczony do workspace. Sekret przechowuj tylko po stronie serwera.
Użyj https://api.shorturl.bot/v1, Authorization: Bearer <api_key> i najpierw GET /workspaces.
2. Utwórz 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"]}'Sukces zwraca 201. Bez domain działa domyślna domena; 2s.gg jest tylko dla istniejących zasobów.
3. Plany i błędy
- Wszystkie: tworzenie, tagi, UTM i back-half w limicie.
- Go+: status i partie do 500 elementów.
- Plus+: cel, harmonogram, wygaśnięcie, przekierowanie i hasło.
- System: 800 żądań/IP/minutę.
401 błędny klucz; 403 odmowa dostępu; 429 limit. Ponawiaj tylko błędy przejściowe.
Dalej
Zobacz dokumentację deweloperską.