- Accueil
- Intégrations
- API REST
API REST
L’API REST complète pour automatiser tous vos liens et QR codes
Chaque écran de TinyLink a ses routes : liens courts, UTM, programmation, QR codes, pages, composants, tags et statistiques. Vos scripts, votre CRM et vos scénarios Make, Zapier ou n8n créent en une requête ce que vous faisiez en dix clics. La documentation donne un exemple de requête et de réponse pour chaque route.
API incluse à partir de l’offre Pro, à 29 € HT par mois, sans engagement. Gratuit pour commencer, sans carte bancaire.
Ce que coûtent les liens faits à la main
Copier l’adresse, construire les UTM, raccourcir, générer le QR code, le télécharger, le ranger : comptez deux minutes par lien. Sur un catalogue de 300 produits, c’est une journée entière, à refaire à chaque campagne. Et une faute de frappe dans un utm_campaign suffit à couper vos statistiques en deux.
Une route pour chaque geste
Ce que vous faites dans le tableau de bord, l’API le fait aussi, avec les mêmes règles et les mêmes plafonds que votre offre. Une seule requête POST /v1/links crée le lien court, ses UTM, sa date de fin et son QR code dynamique. Pour réagir quand un lien expire, ajoutez des alertes automatiques par webhooks ; pour créer vos liens depuis une conversation, le serveur MCP officiel pour Claude.
- Liens courts : adresse personnalisée, UTM, modèles UTM partagés, programmation et nombre de clics maximum
- QR codes dynamiques : créés avec le lien, avec ou sans logo, ou depuis vos modèles
- Pages et composants : créer, modifier, dupliquer une page et y ajouter vos blocs
- Statistiques : clics par jour, provenance, pays et appareils, sur 1 à 90 jours ou depuis la création
Des jetons sous contrôle
Un jeton par espace, avec ses portées : lecture, écriture, suppression. Il n’ouvre que l’espace où il a été généré, est rangé chiffré chez nous, et se régénère ou se révoque en un clic. Chaque réponse indique les requêtes restantes dans la minute (120 par jeton) : vos scripts savent quand ralentir.
Hébergée en France, prête pour vos clients
L’API, vos liens et les statistiques de vos visiteurs restent sur des serveurs français. Avec l’offre Business, chaque client d’agence a son propre espace et son propre jeton : un script mal réglé chez l’un ne touche jamais les liens de l’autre. Les erreurs sont en JSON, avec un code et le champ en cause.
Un catalogue de 300 produits, ses liens et ses QR codes en quelques minutes
Une boutique en ligne prépare ses étiquettes de rayon. Son script parcourt le catalogue et appelle POST /v1/links pour chaque fiche produit : lien court à son nom, UTM « magasin », QR code créé dans la même requête. Moins de trois minutes plus tard, au rythme de 120 requêtes par minute, les 300 QR codes sont prêts à imprimer, et chaque scan remonte dans les statistiques, produit par produit.
Questions fréquentes
À partir de quelle offre l’API est-elle disponible ?
À partir de l’offre Pro, à 29 € HT par mois, sans engagement, avec 5 environnements. L’offre Business, à 79 € HT par mois, en ajoute jusqu’à 25, chaque environnement avec son propre jeton.
Quels langages et quels outils puis-je utiliser ?
Tous ceux qui savent envoyer une requête HTTPS avec un en-tête Authorization : Python, PHP, JavaScript, curl, mais aussi le module de requête HTTP de Make, Zapier ou n8n. Les réponses sont en JSON.
Y a-t-il une limite de requêtes ?
120 requêtes par minute et par jeton. Chaque réponse porte les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset ; au-delà, l’API répond 429 avec le délai à attendre. Les plafonds de votre offre (pages, liens) s’appliquent comme dans le tableau de bord.
Mes données et mes jetons sont-ils en sécurité ?
Vos données sont hébergées en France et le RGPD s’applique. Chaque jeton n’ouvre que son espace, avec les portées que vous choisissez ; il est chiffré chez nous et se révoque à tout moment. Le panneau du jeton affiche la date du dernier appel et le nombre d’appels.
Vos liens créés par vos outils, plus à la main
Créez votre compte, passez à l’offre Pro et générez votre jeton dans Bibliothèque ▸ Intégrations. Votre premier lien par l’API tient en une requête.