Chargement...
Integra Verisav nei tuoi sistemi e automatizza i processi di gestione del servizio post-vendita
L'API Verisav ti consente di integrare tutte le funzionalità della piattaforma nei tuoi sistemi esistenti. Che tu voglia automatizzare la gestione delle garanzie, sincronizzare i dati dei prodotti o creare flussi di lavoro personalizzati, la nostra API REST fornisce tutti gli strumenti necessari.
La nostra API segue gli standard del settore con un'architettura RESTful, risposte JSON e autenticazione sicura. È progettata per essere semplice da usare, ben documentata e performante.
Automatizza i tuoi processi, sincronizza i tuoi dati in tempo reale e crea esperienze personalizzate per i tuoi clienti. L'API Verisav si integra perfettamente con i tuoi sistemi esistenti.
Tutte le richieste all'API Verisav richiedono l'autenticazione tramite un token API. Puoi ottenere le tue credenziali dalla dashboard Verisav.
Accedi allo spazio professionale, poi vai su Impostazioni > Chiavi API per generare o rigenerare il tuo token. Il token rimane valido fino alla revoca manuale.
Authorization: Bearer YOUR_API_TOKENNon condividere mai pubblicamente i tuoi token API. Conservali in sicurezza e rigenerali regolarmente. I token devono essere trasmessi nell'intestazione Authorization di ogni richiesta.
Segui questi semplici passaggi per iniziare a usare l'API Verisav:
Accedi alla tua dashboard Verisav e genera le tue chiavi API dalla sezione Impostazioni.
Aggiungi il tuo token API nell'intestazione Authorization delle tue richieste HTTP: Authorization: Bearer YOUR_API_TOKEN
Testa la tua configurazione recuperando il DPP di un prodotto. Sostituisci ABC123 con un shortId reale:
Esempio:
curl -X GET "https://www.verisav.fr/api/v1/dpp/ABC123" \
-H "Authorization: Bearer YOUR_API_TOKEN"Scopri tutti gli endpoint disponibili per integrare Verisav nei tuoi sistemi. Ogni endpoint è documentato con esempi di richieste e risposte.
Le carte sottostanti mostrano le famiglie di API: vocabolari RDF (DPP, RMA, WTY), GraphQL e REST. La sezione Riferimento API v1 dettaglia l'API REST v1 completa con i percorsi esatti.
Gestione del Passaporto Digitale del Prodotto (DPP)
/api/dppGestione resi e scambi (RMA)
/api/rmaGestione garanzie (WTY)
/api/wtyAccesso a vocabolari e tassonomie
/api/v1/vocabularyAPI GraphQL per query flessibili
/api/graphqlDocumentazione completa di ogni endpoint API Verisav v1. URL base: https://www.verisav.fr. Ogni API è documentata con percorso, metodo, descrizione e parametri. Tutte le richieste richiedono l'header Authorization: Bearer YOUR_API_TOKEN.
Header richiesti: Authorization: Bearer {token}, Content-Type: application/json per POST/PATCH.
/api/v1/dpp/{shortId}Recupera il DPP tramite identificatore breve (shortId).
Parametri: shortId — Identificatore breve del prodotto
/api/v1/dpp?gtin=&serial=Recupera il DPP tramite GTIN + numero di serie.
Parametri: gtin, serial — GTIN e numero di serie
/api/v1/products/{id}/warrantyInformazioni sulla garanzia del prodotto.
Parametri: id — UUID del prodotto
/api/v1/products/{id}/activateAttiva il prodotto (registrazione acquisto).
Parametri: id — UUID del prodotto
/api/v1/products/{id}/usageRecupera i dati di utilizzo del prodotto.
Parametri: id — UUID del prodotto
/api/v1/products/{id}/usageRegistra o aggiorna i dati di utilizzo.
Parametri: id — UUID del prodotto
/api/v1/products/{id}/supply-chainCatena di approvvigionamento e tracciabilità.
Parametri: id — UUID del prodotto
/api/v1/products/bulkRichieste in batch per più prodotti.
Parametri: id — UUID del prodotto
/api/v1/products/{id}/douaneAggiornamento informazioni doganali (UN-CPC, TARIC, ecc.).
Parametri: Body: product_category_code, product_category_scheme (UN-CPC, TARIC)
/api/v1/products/{id}/materialsRecupera la composizione materiali del prodotto.
Parametri: id — UUID del prodotto
/api/v1/products/{id}/materialsRegistra o aggiorna la composizione materiali.
Parametri: id — UUID del prodotto
/api/v1/products/{id}/conformityRecupera le dichiarazioni di conformità.
Parametri: id — UUID del prodotto
/api/v1/products/{id}/conformityRegistra o aggiorna le dichiarazioni di conformità.
Parametri: id — UUID del prodotto
/api/v1/products/{id}/traceabilityRecupera i dati di tracciabilità.
Parametri: id — UUID del prodotto
/api/v1/products/{id}/traceabilityRegistra o aggiorna i dati di tracciabilità.
Parametri: id — UUID del prodotto
/api/v1/products/{id}/verifiable-credentialsRestituisce le Verifiable Credentials (JSON-LD) del prodotto.
Parametri: id — UUID del prodotto
/api/v1/products/{id}/verifiable-credentials?format=jwtRestituisce le Verifiable Credentials firmate in formato JWT.
Parametri: id — UUID del prodotto
/api/v1/products/{id}/transfer-ownershipTrasferisce la proprietà del prodotto a un altro attore.
Parametri: id — UUID del prodotto
/api/v1/products/{id}/auraEsportazione in formato Aura Consortium.
Parametri: id — UUID del prodotto
/api/v1/claimsCrea una nuova reclamo assistenza.
/api/v1/claims/{id}/statusStato di una reclamo per identificativo.
Parametri: id — UUID della reclamo
/api/v1/claims/bulkRichieste in batch per più reclami.
/api/v1/repairers/nearby?lat=&lng=&radius=&limit=Elenco riparatori nelle vicinanze (lat, lng, radius, limit).
Parametri: lat, lng — Coordinate; radius — Raggio (km); limit — Numero massimo
/api/v1/repairers/{id}/availabilityDisponibilità di un riparatore.
Parametri: id — UUID del riparatore
/api/v1/suppliers/dataInvio dati fornitore a Verisav.
/api/v1/webhooksRegistra un webhook per ricevere eventi.
Parametri: url — URL callback; events — Elenco eventi
Codici di risposta: 200 OK, 400 Bad Request, 401 Unauthorized, 404 Not Found, 429 Too Many Requests, 500 Server Error
DPP — Esempio di richiesta
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"Registra un webhook tramite POST /api/v1/webhooks per ricevere notifiche in tempo reale (creazione reclamo, trasferimento proprietà, ecc.). Perfetto per sincronizzare i tuoi sistemi e automatizzare i tuoi flussi di lavoro.
Eventi supportati: claim.created, ownership.transferred, product.activated, ecc.
Esempio di registrazione:
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"]
}'Gli errori sono restituiti in JSON: {"error": "messaggio", "code": "ERROR_CODE"}. Il corpo della richiesta viene analizzato per fornire dettagli sui campi non validi.
L'API applica limiti di frequenza per token. In caso di superamento, viene restituita una risposta 429 Too Many Requests con l'header Retry-After. Contattaci per volumi elevati.
Il nostro team è qui per aiutarti a integrare l'API Verisav nei tuoi sistemi. Consulta la nostra documentazione completa o contatta il nostro supporto.