Chargement...
Intégrez Verisav dans vos systèmes et automatisez vos processus de gestion après-vente
L'API Verisav vous permet d'intégrer toutes les fonctionnalités de la plateforme dans vos systèmes existants. Que vous souhaitiez automatiser la gestion des garanties, synchroniser les données produits, ou créer des workflows personnalisés, notre API REST vous offre tous les outils nécessaires.
Notre API suit les standards de l'industrie avec une architecture RESTful, des réponses JSON, et une authentification sécurisée. Elle est conçue pour être simple à utiliser, bien documentée, et performante.
Automatisez vos processus, synchronisez vos données en temps réel, et créez des expériences personnalisées pour vos clients. L'API Verisav s'intègre parfaitement avec vos systèmes existants.
Toutes les requêtes à l'API Verisav nécessitent une authentification via un token API. Vous pouvez obtenir vos credentials depuis votre tableau de bord Verisav.
Connectez-vous à l'espace professionnel, puis accédez à Paramètres > Clés API pour générer ou régénérer votre token. Le token reste valide jusqu'à sa révocation manuelle.
Authorization: Bearer YOUR_API_TOKENNe partagez jamais vos tokens API publiquement. Conservez-les en sécurité et régénérez-les régulièrement. Les tokens doivent être transmis dans l'en-tête Authorization de chaque requête.
Suivez ces étapes simples pour commencer à utiliser l'API Verisav :
Connectez-vous à votre tableau de bord Verisav et générez vos clés API depuis la section Paramètres.
Ajoutez votre token API dans l'en-tête Authorization de vos requêtes HTTP : Authorization: Bearer YOUR_API_TOKEN
Testez votre configuration en récupérant le DPP d'un produit. Remplacez ABC123 par un shortId réel :
Exemple :
curl -X GET "https://www.verisav.fr/api/v1/dpp/ABC123" \
-H "Authorization: Bearer YOUR_API_TOKEN"Découvrez tous les endpoints disponibles pour intégrer Verisav dans vos systèmes. Chaque endpoint est documenté avec des exemples de requêtes et de réponses.
Les cartes ci-dessous présentent les familles d'APIs : vocabulaires RDF (DPP, RMA, WTY), GraphQL et REST. La section Référence API v1 détaille l'API REST v1 complète avec tous les chemins exacts.
Gestion du Passeport Produit Numérique (DPP)
/api/dppGestion des retours et échanges (RMA)
/api/rmaGestion des garanties (WTY)
/api/wtyAccès aux vocabulaires et taxonomies
/api/v1/vocabularyAPI GraphQL pour requêtes flexibles
/api/graphqlDocumentation complète de chaque endpoint de l'API Verisav v1. Base URL : https://www.verisav.fr. Chaque API est documentée avec son chemin, sa méthode, sa description et ses paramètres. Toutes les requêtes nécessitent l'en-tête Authorization: Bearer YOUR_API_TOKEN.
Headers requis : Authorization: Bearer {token}, Content-Type: application/json pour POST/PATCH.
/api/v1/dpp/{shortId}Récupère le DPP par identifiant court (shortId).
Paramètres : shortId — Identifiant court du produit
/api/v1/dpp?gtin=&serial=Récupère le DPP par GTIN + numéro de série.
Paramètres : gtin, serial — GTIN et numéro de série
/api/v1/products/{id}/warrantyInformations de garantie du produit.
Paramètres : id — UUID du produit
/api/v1/products/{id}/activateActive le produit (enregistrement achat).
Paramètres : id — UUID du produit
/api/v1/products/{id}/usageRécupère les données d'utilisation du produit.
Paramètres : id — UUID du produit
/api/v1/products/{id}/usageEnregistre ou met à jour les données d'utilisation.
Paramètres : id — UUID du produit
/api/v1/products/{id}/supply-chainChaîne d'approvisionnement et traçabilité.
Paramètres : id — UUID du produit
/api/v1/products/bulkRequêtes groupées sur plusieurs produits.
Paramètres : id — UUID du produit
/api/v1/products/{id}/douaneMise à jour des informations douanières (UN-CPC, TARIC, etc.).
Paramètres : Body : product_category_code, product_category_scheme (UN-CPC, TARIC)
/api/v1/products/{id}/materialsRécupère la composition matériaux du produit.
Paramètres : id — UUID du produit
/api/v1/products/{id}/materialsEnregistre ou met à jour la composition matériaux.
Paramètres : id — UUID du produit
/api/v1/products/{id}/conformityRécupère les déclarations de conformité.
Paramètres : id — UUID du produit
/api/v1/products/{id}/conformityEnregistre ou met à jour les déclarations de conformité.
Paramètres : id — UUID du produit
/api/v1/products/{id}/traceabilityRécupère les données de traçabilité.
Paramètres : id — UUID du produit
/api/v1/products/{id}/traceabilityEnregistre ou met à jour les données de traçabilité.
Paramètres : id — UUID du produit
/api/v1/products/{id}/verifiable-credentialsRetourne les Verifiable Credentials (JSON-LD) du produit.
Paramètres : id — UUID du produit
/api/v1/products/{id}/verifiable-credentials?format=jwtRetourne les Verifiable Credentials signés en format JWT.
Paramètres : id — UUID du produit
/api/v1/products/{id}/transfer-ownershipTransfère la propriété du produit à un autre acteur.
Paramètres : id — UUID du produit
/api/v1/products/{id}/auraExport au format Aura Consortium.
Paramètres : id — UUID du produit
/api/v1/claimsCréation d'une nouvelle réclamation SAV.
/api/v1/claims/{id}/statusStatut d'une réclamation par identifiant.
Paramètres : id — UUID de la réclamation
/api/v1/claims/bulkRequêtes groupées sur plusieurs réclamations.
/api/v1/repairers/nearby?lat=&lng=&radius=&limit=Liste des réparateurs à proximité (lat, lng, radius, limit).
Paramètres : lat, lng — Coordonnées ; radius — Rayon (km) ; limit — Nombre max
/api/v1/repairers/{id}/availabilityDisponibilités d'un réparateur.
Paramètres : id — UUID du réparateur
/api/v1/suppliers/dataEnvoi de données fournisseur vers Verisav.
/api/v1/webhooksEnregistrement d'un webhook pour recevoir des événements.
Paramètres : url — URL de callback ; events — Liste des événements
Codes de réponse : 200 OK, 400 Bad Request, 401 Unauthorized, 404 Not Found, 429 Too Many Requests, 500 Server Error
DPP — Exemple de requête
curl -X GET "https://www.verisav.fr/api/v1/dpp/ABC123" \
-H "Authorization: Bearer YOUR_API_TOKEN"Produits — Activer
curl -X POST "https://www.verisav.fr/api/v1/products/{id}/activate" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'Réparateurs — À proximité
curl -X GET "https://www.verisav.fr/api/v1/repairers/nearby?lat=44.84&lng=-0.58&radius=50&limit=10" \
-H "Authorization: Bearer YOUR_API_TOKEN"Enregistrez un webhook via POST /api/v1/webhooks pour recevoir des notifications en temps réel (création de réclamation, transfert de propriété, etc.). Parfait pour synchroniser vos systèmes et automatiser vos workflows.
Événements supportés : claim.created, ownership.transferred, product.activated, etc.
Exemple d'enregistrement :
curl -X POST "https://www.verisav.fr/api/v1/webhooks" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-domain.com/webhook",
"events": ["claim.created", "ownership.transferred", "product.activated"]
}'Les erreurs sont retournées en JSON : {"error": "message", "code": "ERROR_CODE"}. Le corps de la requête est analysé pour fournir des détails sur les champs invalides.
L'API applique des limites de débit par token. En cas de dépassement, une réponse 429 Too Many Requests est retournée avec l'en-tête Retry-After. Contactez-nous pour des besoins de volume élevé.
Notre équipe est là pour vous aider à intégrer l'API Verisav dans vos systèmes. Consultez notre documentation complète ou contactez notre support.