Si vous cherchez une alternative à l'API Bitly, vous avez probablement heurté l'un de ces deux murs : des limites de débit qui restreignent votre automatisation sur le plan que vous pouvez vous permettre, ou une fonctionnalité dont vous avez besoin qui se trouve derrière un palier que vous ne voulez pas acheter. Voici un guide destiné aux développeurs sur ce qui compte réellement dans une API de raccourcisseur - limites, idempotence, webhooks, SDK - et sur la façon dont le changement se déroule en pratique.
Cet article fait partie du cluster ingénierie. Pour la forme des requêtes et les bases d'authentification que tous partagent, le guide de l'API gratuite de raccourcissement d'URL est la base sur laquelle celui-ci s'appuie.
Où l'API Bitly fait mal
L'API de Bitly est compétente, et pour un usage à faible volume, elle convient. La friction apparaît à grande échelle. Les limites de débit vont d'environ 1 000 requêtes par mois sur les paliers les plus bas à plus de 150 000 sur les paliers supérieurs, avec des plafonds par minute et par heure superposés, documentés dans la référence de l'API Bitly. Sur un plan moins cher, ces plafonds restreignent précisément les tâches automatisées pour lesquelles une API existe.
Le second mur est le verrouillage. La structure de groupes et d'organisations, certains points de terminaison d'analytique, et les volumes d'appels plus élevés se trouvent dans les paliers supérieurs, si bien que la version de l'API pour laquelle vous pouvez justifier un budget n'est souvent pas celle que votre intégration supposait. Aucun des deux n'est vraiment un défaut - c'est ainsi que la tarification est construite - mais les deux expliquent pourquoi les équipes commencent à chercher ailleurs. Le démontage de l'API Bitly par Rebrandly arrive à la même conclusion sur les points où les limites gênent.
Ce qu'une API de raccourcisseur pensée pour les développeurs devrait vous offrir
Une fois la marque mise de côté, une bonne API de raccourcisseur se résume à quatre choses.
- Des limites de débit sur lesquelles vous pouvez planifier. Des plafonds documentés par fenêtre, à l'échelle de l'espace de travail, pas si serrés sur les paliers d'entrée qu'une tâche par lots les déclenche. Le prévisible bat l'élevé-mais-opaque.
- Des clés d'idempotence. Envoyez une clé stable par requête logique, et une nouvelle tentative après un délai d'expiration renvoie le lien d'origine au lieu d'en créer un doublon. Sans cela, chaque nouvelle tentative est un risque.
- Des webhooks. Poussez les événements de clic vers votre point de terminaison plutôt que de vous forcer à interroger une API d'analytique à intervalles réguliers.
- De vrais SDK. Des bibliothèques officielles dans les langages que vous utilisez, pour ne pas avoir à coder à la main l'authentification et la pagination.
L'analyse approfondie des limites de débit et de l'idempotence explique pourquoi le second point compte plus que le plafond brut de requêtes : une API sûre pour les nouvelles tentatives à 10 000 requêtes bat une API fragile à 100 000.
La migration est plus simple que vous ne le pensez (sauf sur un point)
L'appel API change à peine. L'appel de création de lien de Bitly et la plupart des alternatives ont la même forme : s'authentifier avec un jeton Bearer, envoyer une longue URL en POST, récupérer le lien court dans le JSON. Changer de fournisseur consiste surtout en une nouvelle URL de base, un nouveau jeton, et la correspondance des noms de champs.
# Bitly
curl -X POST https://api-ssl.bitly.com/v4/shorten \
-H "Authorization: Bearer $BITLY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"long_url": "https://example.com/page"}'
# Elido - same shape, plus an idempotency key
curl -X POST https://api.elido.app/v1/links \
-H "Authorization: Bearer $ELIDO_API_KEY" \
-H "Idempotency-Key: 5f3e-once" \
-H "Content-Type: application/json" \
-d '{"destination_url": "https://example.com/page"}'
Si vous l'appelez depuis du code, le tutoriel Python montre les schémas de nouvelle tentative et d'idempotence à mettre en place autour de l'un ou l'autre appel.
La partie qui n'est pas petite : vos liens existants. Un lien court ne continue à fonctionner que si vous contrôlez le domaine sur lequel il vit. Les liens sur bit.ly ne peuvent pas être déplacés - ce domaine appartient à Bitly. Seuls les liens à votre marque sur votre propre domaine peuvent être redirigés vers un nouveau fournisseur sans se casser. La vraie question de migration est donc « combien de mes liens actifs sont sur un domaine que je possède ? » - et la réponse détermine à quel point le changement sera propre. Le guide de migration Bitly détaille les étapes de domaine et de redirection.
Faire son choix
La liste honnête pour une API destinée aux développeurs est Short.io, Rebrandly, Dub et Elido - chacun expose une véritable API avec des SDK. Short.io et Dub misent sur le prix orienté développeurs ; Rebrandly mise sur l'automatisation des domaines à la marque. Là où Elido se distingue, c'est par la combinaison que les autres ne mettent pas au centre : idempotence et webhooks par défaut, plus la résidence des données dans l'UE, de sorte que les données de clic restent dans la région UE plutôt que d'être transférées à l'extérieur. Si votre stack a une contrainte de conformité en plus d'une contrainte technique, cette combinaison est la raison de s'y intéresser - et vous pouvez développer contre l'API sur le plan gratuit pour tester l'adéquation avant de vous engager.
Quel que soit votre choix, jugez-le sur les limites et l'idempotence, pas sur le marketing. Ce sont les deux éléments qui déterminent si votre intégration est ennuyeuse et fiable, ou une source d'alertes à 2 heures du matin.
Lire la série pilier
Cet article fait partie du cluster ingénierie. Commencez par le guide de l'API gratuite de raccourcissement d'URL, puis l'analyse approfondie des limites de débit et de l'idempotence. La référence en direct est la documentation de l'API.
À lire aussi sur le blog
Questions fréquentes
Quelle est une bonne alternative à l'API Bitly pour les développeurs ?
Cherchez un raccourcisseur dont l'API offre des limites de débit raisonnables, pas agressivement restreintes sur les paliers bas, des clés d'idempotence pour que les nouvelles tentatives ne créent pas de doublons, des webhooks pour les événements de clic, et des SDK officiels. Short.io, Rebrandly, Dub et Elido exposent tous des API pour développeurs ; celle qui convient dépend de vos besoins en matière de limite de débit et de l'importance de la résidence des données dans l'UE.
Pourquoi les développeurs quittent-ils l'API Bitly ?
Deux raisons reviennent le plus souvent : des limites de débit qui restreignent les flux de travail automatisés sur les plans les moins chers, et des fonctionnalités verrouillées derrière des paliers supérieurs, si bien que l'API que vous pouvez vous permettre n'est pas celle dont vous avez besoin. Le changement se fait généralement vers un raccourcisseur avec des limites plus claires et l'idempotence intégrée, afin que les tâches par lots puissent être relancées en toute sécurité.
Est-il difficile de migrer hors de l'API Bitly ?
L'appel API en lui-même est presque identique - envoyer une URL de destination en requête POST, récupérer un lien court en retour - donc changer le point de terminaison et l'authentification est un petit changement. Le vrai travail concerne les liens déjà en ligne sur bit.ly : ceux-là ne peuvent pas être déplacés. Seuls les liens à votre marque sur un domaine que vous possédez peuvent être redirigés vers un nouveau fournisseur sans se casser.
Quelles sont les limites de débit de l'API Bitly ?
Elles varient selon le plan, allant approximativement de 1 000 requêtes par mois sur les paliers les plus bas jusqu'à plus de 150 000 sur les paliers supérieurs, avec en plus des plafonds par minute et par heure. Le problème concret est que les paliers inférieurs restreignent fortement, ce qui casse les tâches en masse ou automatisées et pousse les équipes à regarder ailleurs.
Essayer Elido
Collez une URL, obtenez un lien court
Sans inscription. Lien actif 30 jours. Inscrivez-vous pour le garder pour toujours.
Gratuit, sans inscription · 2 par jour