Chargement...
Integrieren Sie Verisav in Ihre Systeme und automatisieren Sie Ihre After-Sales-Service-Prozesse
Die Verisav API ermöglicht es Ihnen, alle Plattformfunktionen in Ihre bestehenden Systeme zu integrieren. Ob Sie die Garantieverwaltung automatisieren, Produktdaten synchronisieren oder benutzerdefinierte Workflows erstellen möchten, unsere REST API bietet alle notwendigen Tools.
Unsere API folgt Branchenstandards mit einer RESTful-Architektur, JSON-Antworten und sicherer Authentifizierung. Sie ist darauf ausgelegt, einfach zu verwenden, gut dokumentiert und performant zu sein.
Automatisieren Sie Ihre Prozesse, synchronisieren Sie Ihre Daten in Echtzeit und erstellen Sie personalisierte Erfahrungen für Ihre Kunden. Die Verisav API integriert sich nahtlos in Ihre bestehenden Systeme.
Alle Anfragen an die Verisav API erfordern eine Authentifizierung über ein API-Token. Sie können Ihre Anmeldedaten aus Ihrem Verisav-Dashboard erhalten.
Melden Sie sich im professionellen Bereich an und gehen Sie zu Einstellungen > API-Schlüssel, um Ihren Token zu generieren oder zu regenerieren. Der Token bleibt gültig bis zur manuellen Widerrufung.
Authorization: Bearer YOUR_API_TOKENTeilen Sie Ihre API-Tokens niemals öffentlich. Bewahren Sie sie sicher auf und regenerieren Sie sie regelmäßig. Tokens müssen im Authorization-Header jeder Anfrage übermittelt werden.
Befolgen Sie diese einfachen Schritte, um die Verisav API zu verwenden:
Melden Sie sich in Ihrem Verisav-Dashboard an und generieren Sie Ihre API-Schlüssel im Bereich Einstellungen.
Fügen Sie Ihr API-Token im Authorization-Header Ihrer HTTP-Anfragen hinzu: Authorization: Bearer YOUR_API_TOKEN
Testen Sie Ihre Konfiguration, indem Sie den DPP eines Produkts abrufen. Ersetzen Sie ABC123 durch eine echte shortId:
Beispiel:
curl -X GET "https://www.verisav.fr/api/v1/dpp/ABC123" \
-H "Authorization: Bearer YOUR_API_TOKEN"Entdecken Sie alle verfügbaren Endpoints, um Verisav in Ihre Systeme zu integrieren. Jeder Endpoint ist mit Anfrage- und Antwortbeispielen dokumentiert.
Die Karten unten zeigen API-Familien: RDF-Vokabulare (DPP, RMA, WTY), GraphQL und REST. Der Abschnitt API v1 Referenz enthält die vollständige REST v1 API mit genauen Pfaden.
Verwaltung des Digitalen Produktpasses (DPP)
/api/dppVerwaltung von Rücksendungen und Umtausch (RMA)
/api/rmaGarantieverwaltung (WTY)
/api/wtyZugriff auf Vokabulare und Taxonomien
/api/v1/vocabularyGraphQL API für flexible Abfragen
/api/graphqlVollständige Dokumentation für jeden Verisav API v1 Endpoint. Basis-URL: https://www.verisav.fr. Jede API ist mit Pfad, Methode, Beschreibung und Parametern dokumentiert. Alle Anfragen benötigen den Header Authorization: Bearer YOUR_API_TOKEN.
Erforderliche Header: Authorization: Bearer {token}, Content-Type: application/json für POST/PATCH.
/api/v1/dpp/{shortId}Ruft den DPP anhand der Kurz-ID (shortId) ab.
Parameter: shortId — Kurz-ID des Produkts
/api/v1/dpp?gtin=&serial=Ruft den DPP anhand GTIN + Seriennummer ab.
Parameter: gtin, serial — GTIN und Seriennummer
/api/v1/products/{id}/warrantyProduktgarantieinformationen.
Parameter: id — Produkt-UUID
/api/v1/products/{id}/activateAktiviert das Produkt (Kaufregistrierung).
Parameter: id — Produkt-UUID
/api/v1/products/{id}/usageRuft Produktnutzungsdaten ab.
Parameter: id — Produkt-UUID
/api/v1/products/{id}/usageErfasst oder aktualisiert Nutzungsdaten.
Parameter: id — Produkt-UUID
/api/v1/products/{id}/supply-chainLieferkette und Rückverfolgbarkeit.
Parameter: id — Produkt-UUID
/api/v1/products/bulkSammelanfragen für mehrere Produkte.
Parameter: id — Produkt-UUID
/api/v1/products/{id}/douaneAktualisierung der Zollinformationen (UN-CPC, TARIC usw.).
Parameter: Body: product_category_code, product_category_scheme (UN-CPC, TARIC)
/api/v1/products/{id}/materialsRuft die Materialzusammensetzung des Produkts ab.
Parameter: id — Produkt-UUID
/api/v1/products/{id}/materialsErfasst oder aktualisiert die Materialzusammensetzung.
Parameter: id — Produkt-UUID
/api/v1/products/{id}/conformityRuft Konformitätserklärungen ab.
Parameter: id — Produkt-UUID
/api/v1/products/{id}/conformityErfasst oder aktualisiert Konformitätserklärungen.
Parameter: id — Produkt-UUID
/api/v1/products/{id}/traceabilityRuft Rückverfolgbarkeitsdaten ab.
Parameter: id — Produkt-UUID
/api/v1/products/{id}/traceabilityErfasst oder aktualisiert Rückverfolgbarkeitsdaten.
Parameter: id — Produkt-UUID
/api/v1/products/{id}/verifiable-credentialsGibt die Verifiable Credentials (JSON-LD) des Produkts zurück.
Parameter: id — Produkt-UUID
/api/v1/products/{id}/verifiable-credentials?format=jwtGibt signierte Verifiable Credentials im JWT-Format zurück.
Parameter: id — Produkt-UUID
/api/v1/products/{id}/transfer-ownershipÜberträgt das Produkteigentum an einen anderen Akteur.
Parameter: id — Produkt-UUID
/api/v1/products/{id}/auraExport im Aura Consortium-Format.
Parameter: id — Produkt-UUID
/api/v1/claimsErstellt eine neue Kundendienst-Reklamation.
/api/v1/claims/{id}/statusReklamationsstatus anhand der ID.
Parameter: id — Reklamations-UUID
/api/v1/claims/bulkSammelanfragen für mehrere Reklamationen.
/api/v1/repairers/nearby?lat=&lng=&radius=&limit=Liste der Reparatoren in der Nähe (lat, lng, radius, limit).
Parameter: lat, lng — Koordinaten; radius — Radius (km); limit — Max. Anzahl
/api/v1/repairers/{id}/availabilityVerfügbarkeit eines Reparators.
Parameter: id — Reparator-UUID
/api/v1/suppliers/dataLieferantendaten an Verisav senden.
/api/v1/webhooksWebhook registrieren, um Ereignisse zu empfangen.
Parameter: url — Callback-URL; events — Ereignisliste
Antwortcodes: 200 OK, 400 Bad Request, 401 Unauthorized, 404 Not Found, 429 Too Many Requests, 500 Server Error
DPP — Beispielanfrage
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"Registrieren Sie einen Webhook über POST /api/v1/webhooks, um Echtzeit-Benachrichtigungen zu erhalten (Reklamationserstellung, Eigentumsübertragung usw.). Perfekt zum Synchronisieren Ihrer Systeme und Automatisieren Ihrer Workflows.
Unterstützte Ereignisse: claim.created, ownership.transferred, product.activated usw.
Registrierungsbeispiel:
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"]
}'Fehler werden in JSON zurückgegeben: {"error": "Nachricht", "code": "ERROR_CODE"}. Der Anfragekörper wird analysiert, um Details zu ungültigen Feldern zu liefern.
Die API wendet Ratenlimits pro Token an. Bei Überschreitung wird eine 429 Too Many Requests Antwort mit dem Retry-After-Header zurückgegeben. Kontaktieren Sie uns für hohe Volumen.
Unser Team hilft Ihnen dabei, die Verisav API in Ihre Systeme zu integrieren. Sehen Sie sich unsere vollständige Dokumentation an oder kontaktieren Sie unseren Support.