L'API publique ShortURL.bot est une interface serveur à serveur pour les ressources du workspace. Elle partage droits et compteurs avec le tableau de bord : aucun contournement de limite ni quota séparé.
1. Créez et limitez une clé
Créez-la dans Paramètres → Clés API. Disponible sur toutes les offres, elle appartient à l'abonnement et peut être limitée par workspace. Stockez le secret côté serveur, jamais dans navigateur, app, dépôt ou logs.
Utilisez https://api.shorturl.bot/v1, Authorization: Bearer <api_key>, puis GET /workspaces.
2. Créez un lien
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"]}'Le succès renvoie 201. Omettez domain pour la valeur par défaut ; 2s.gg reste réservé aux anciens actifs.
3. Offres et erreurs
- Toutes : création, tags, UTM et back-half dans le quota.
- Go+ : statut et lots de 500 éléments maximum.
- Plus+ : destination, programmation, expiration, redirection et mot de passe.
- Système : 800 requêtes/IP/minute en plus des quotas.
401 clé invalide ; 403 accès ou fonction refusé ; 429 quota ou débit. Ne relancez que les erreurs transitoires.
Étape suivante
Consultez la référence développeur.