Panoramica degli endpoint

Tutti gli endpoint usano l’URL di base: https://your-app-domain.com/api/public

Idoneità alla garanzia

Metodo	Percorso	Descrizione
GET / POST	/warranty-eligibility	Verifica l’idoneità alla garanzia di un prodotto
POST	/warranty/eligibility	Verifica l’idoneità di una riga d’ordine
GET / POST	/assess-eligibility	Rivaluta in blocco l’idoneità per un’organizzazione (admin)
GET	/assess-eligibility/all	Valuta in blocco tutte le organizzazioni (admin)

Garanzie

Metodo	Percorso	Descrizione
GET	/warranty/{warrantyId}	Ottieni i dettagli di una garanzia per ID

Polizze

Metodo	Percorso	Descrizione
GET	/policies/fetch	Ottieni tutte le polizze di un cliente
GET	/policies/fetch/{policyId}	Ottieni una polizza specifica per ID
POST	/policies/fetch/order-line-item-policy	Trova la polizza di una riga d’ordine
POST	/policies/validate	Convalida una polizza tramite ID e nome dell’ordine

Sinistri

Metodo	Percorso	Descrizione
POST	/claims/submit	Apri un sinistro in garanzia su una polizza
POST	/claims/submit-manual	Apri un sinistro su iniziativa del commerciante (nessuna polizza richiesta)
GET	/claims/fetch	Ottieni i sinistri di una polizza e di un cliente
GET	/claims/{id}/evidence	Ottieni i file di prova di un sinistro
POST	/claims/upload-urls	Genera URL di caricamento prefirmati per le prove
POST	/claims/upload	Carica direttamente le prove di un sinistro
POST	/claims/evidence	Associa i metadati delle prove a un sinistro

Prodotti

Metodo	Percorso	Descrizione
GET	/products/search	Cerca prodotti per titolo, SKU o codice a barre
GET	/products/eligibility	Verifica l’idoneità di più prodotti
POST	/products/register	Registra un prodotto per la copertura in garanzia

Clienti

Metodo	Percorso	Descrizione
GET	/customers/orders	Ottieni gli ordini di un cliente

Registrazione

Metodo	Percorso	Descrizione
GET	/registration/lookup	Cerca una registrazione per numero

Numeri di serie

Metodo	Percorso	Descrizione
POST	/serial-numbers/validate	Convalida un numero di serie

Analisi

Metodo	Percorso	Descrizione
POST	/analytics/events	Invia gli eventi di analisi del widget

Configurazione

Metodo	Percorso	Descrizione
GET / POST	/config	Ottieni la configurazione e le traduzioni del widget

Stato dell’ordine

Metodo	Percorso	Descrizione
GET	/order-status	Ottieni lo stato di un ordine

POS

Metodo	Percorso	Descrizione
GET	/pos/customer-search	Cerca clienti in un contesto POS

Integrazione Shopify

Metodo	Percorso	Descrizione
GET	/shopify/auth/callback	Callback OAuth per l’installazione dell’app
POST	/shopify/webhooks	Ricevi gli eventi Webhook di Shopify
POST	/shopify/post-purchase/sign-changeset	Firma i changeset dell’estensione post-acquisto

Sincronizzazione dei prodotti

Metodo	Percorso	Descrizione
POST	/sync-products	Sincronizza i prodotti di un’organizzazione
POST	/sync-products/all	Sincronizza i prodotti di tutte le organizzazioni

Stato di salute

Metodo	Percorso	Descrizione
GET	/health	Verifica lo stato di salute dell’API

Restituisce 200 (integro), 206 (degradato) o 503 (non integro).

Correlati

• Autenticazione — Configurazione della chiave API e limiti di frequenza
• API Garanzie — Riferimento dettagliato degli endpoint delle garanzie
• API Sinistri — Riferimento dettagliato degli endpoint dei sinistri
• API Polizze — Riferimento dettagliato degli endpoint delle polizze