API développeur
Générez des étiquettes GARAN à grande échelle, par programmation
Une API REST claire pour l'étiquette de garantie de durabilité de l'UE. Intégrez-la dans votre PIM, votre boutique en ligne ou votre pipeline de build et obtenez des étiquettes conformes aux exigences dans chaque format dont vous avez besoin.
Conçue pour l'intégration
- REST via JSON:API
- Des ressources prévisibles, un filtrage et une pagination conformes au standard JSON:API, afin que votre bibliothèque cliente effectue l'essentiel du travail.
- Étiquettes individuelles ou lots
- Créez une étiquette par requête ou mettez en file d'attente un lot de 500 lignes au maximum, généré en arrière-plan et renvoyé sous forme de ZIP.
- Tous les formats et toutes les variantes
- SVG, PDF, PNG, JPG et WebP, dans les variantes couleur, noir et blanc et imbriquée, le tout depuis la même requête.
Points d'accès
Ce que vous pouvez automatiser
L'API reprend tout ce que vous pouvez faire manuellement, sans les clics. Un aperçu général de ce que fait chaque partie.
- Créer une étiquette
- Envoyez une durée de garantie, une marque et un modèle, et recevez l'étiquette avec des liens de téléchargement prêts à l'emploi par format.
- Parcourir votre bibliothèque
- Listez et récupérez chaque étiquette générée par votre compte, les plus récentes en premier, prêtes à être regénérées à tout moment sans frais supplémentaires.
- Mettre en file d'attente un lot
- Soumettez plusieurs lignes à la fois et interrogez le lot jusqu'à ce qu'il soit prêt, puis récupérez le ZIP terminé.
- Vérifier l'utilisation et les crédits
- Consultez votre solde de crédits actuel et votre activité récente afin que votre intégration puisse surveiller le portefeuille.
Conventions
Prévisible par conception
L'API suit un petit ensemble de règles partout, de sorte qu'une fois un point d'accès intégré, vous savez comment se comporte le reste.
- Authentification par jeton
- Créez des jetons d'accès personnels dans vos paramètres et envoyez-les comme jeton Bearer dans l'en-tête Authorization. Révoquez-en à tout moment.
- Points d'accès versionnés
- Tout se trouve sous /api/v1, de sorte que les modifications futures ne cassent jamais votre intégration existante sans préavis.
- Type de média JSON:API
- Les requêtes et les réponses utilisent application/vnd.api+json, avec des ressources, des relations et une enveloppe cohérente.
- Déterministe et mis en cache
- Les trois mêmes entrées produisent toujours la même étiquette. Les réponses portent un ETag, de sorte que les requêtes répétées renvoient un rapide 304 Not Modified.
- Liens de téléchargement signés
- Les fichiers générés sont servis via des URL signées de courte durée, ce qui vous permet de transmettre un lien directement à un navigateur sans exposer votre jeton.
- Limites de débit
- Une limite généreuse par compte maintient le service équitable et réactif. La limite est renvoyée dans des en-têtes standard afin que vous puissiez vous adapter progressivement.
- Erreurs structurées
- Les erreurs sont renvoyées sous forme de documents d'erreur JSON:API pointant vers l'attribut exact qui a échoué, ce qui facilite la remontée des problèmes de validation.
Tarification
Paiement à l'unité par étiquette
Vous êtes facturé une seule fois par étiquette unique, identifiée par sa durée, sa marque et son modèle. Retélécharger une étiquette, demander d'autres formats ou récupérer une étiquette que vous possédez déjà n'entraîne aucun frais supplémentaire.
Rechargez des crédits prépayés ou passez au paiement à l'usage et réglez chaque mois exactement ce que vous générez. Les lignes en double dans un lot ne sont comptées qu'une seule fois.
Vous préférez sans code ?
Téléversez un tableur et générez les mêmes étiquettes par lot, sans intégration requise.
À grande échelle
Générez des centaines d'étiquettes automatiquement
Un compte gratuit vous permet de générer les étiquettes GARAN par lot ou via l'API, au lieu d'une à la fois. Vous ne payez qu'au moment de passer à l'échelle.
- Génération par lot à partir d'un CSV, jusqu'à 500 lignes par fichier, renvoyée en ZIP.
- API REST pour votre PIM, votre boutique en ligne ou votre pipeline de build.
- Les cinq formats et trois variantes à partir d'une seule requête.
- Bibliothèque enregistrée, facturée une fois par étiquette unique (prépayé ou à l'usage).