Qu'est-ce que Veille ?
Le fonctionnement de Veille et ce que comprend un compte.
Veille est une API HTTP que vous appelez depuis votre backend, votre plateforme d'automatisation ou un agent IA. Vous envoyez une requête avec votre clé API, nous faisons le travail et vous recevez du JSON structuré. Chaque appel réussi consomme des crédits sur le solde de votre compte.
200
4xx / 5xx
Crédits
Les trois éléments nécessaires
| Quoi | Où |
|---|---|
| Un compte | Inscrivez-vous sur le tableau de bord : https://app.veille.io |
| Une clé API | Clés API dans la barre latérale, envoyée dans l'en-tête x-api-key |
| Des crédits | Inclus dans votre offre, rechargés manuellement ou automatiquement |
Ce qui se passe lors d'une requête
Votre backend envoie l'appel
La requête arrive sur https://api.veille.io avec l'en-tête x-api-key. Ne placez jamais la clé dans un navigateur ou une application mobile.
Nous vérifions la clé et le solde
Une clé invalide, inactive ou expirée renvoie 401. Un solde vide ou une facture impayée renvoie 402. Les limites de débit renvoient aussi 401, avec un message qui nomme la limite.
Nous exécutons le point d'accès et renvoyons du JSON
En cas de succès, vous recevez des données structurées. L'appel est enregistré dans Journaux API avec son statut, sa durée et son coût en crédits.
Les crédits ne sont déduits que si l'appel réussit
Les réponses réussies sont facturées. Les échecs d'authentification, les mauvais paramètres et les erreurs serveur ne coûtent rien — vous pouvez expérimenter sans consommer le solde.
À quoi sert le tableau de bord
L'API est sans état : vous vous authentifiez avec une clé et recevez une réponse. Le tableau de bord sert à gérer tout le reste — parcourir la Bibliothèque de points d'accès, émettre et révoquer des clés, surveiller la consommation, télécharger les factures et inviter des collègues. Vous n'en avez pas besoin pour faire un appel, mais il est indispensable pour garder une intégration en bonne santé.
Après l'inscription, vous arrivez sur la Bibliothèque. Le solde restant s'affiche aussi en bas de la barre latérale sur tous les écrans, pour savoir en permanence de quelle marge vous disposez.