Endpunkte im Überblick

Alle Endpunkte verwenden die Basis-URL: https://your-app-domain.com/api/public

Garantieberechtigung

Methode	Pfad	Beschreibung
GET / POST	/warranty-eligibility	Garantieberechtigung für ein Produkt prüfen
POST	/warranty/eligibility	Berechtigung für eine Bestellposition prüfen
GET / POST	/assess-eligibility	Berechtigung für eine Organisation im Batch neu bewerten (Admin)
GET	/assess-eligibility/all	Batch-Bewertung für alle Organisationen (Admin)

Garantien

Methode	Pfad	Beschreibung
GET	/warranty/{warrantyId}	Garantiedetails nach ID abrufen

Policen

Methode	Pfad	Beschreibung
GET	/policies/fetch	Alle Policen eines Kunden abrufen
GET	/policies/fetch/{policyId}	Eine bestimmte Police nach ID abrufen
POST	/policies/fetch/order-line-item-policy	Die Police zu einer Bestellposition finden
POST	/policies/validate	Eine Police anhand von ID und Bestellname validieren

Ansprüche

Methode	Pfad	Beschreibung
POST	/claims/submit	Einen Garantieanspruch zu einer Police einreichen
POST	/claims/submit-manual	Einen vom Händler veranlassten Anspruch einreichen (keine Police erforderlich)
GET	/claims/fetch	Ansprüche zu einer Police und einem Kunden abrufen
GET	/claims/{id}/evidence	Nachweisdateien zu einem Anspruch abrufen
POST	/claims/upload-urls	Vorsignierte Upload-URLs für Nachweise generieren
POST	/claims/upload	Nachweise zu einem Anspruch direkt hochladen
POST	/claims/evidence	Nachweis-Metadaten an einen Anspruch anhängen

Produkte

Methode	Pfad	Beschreibung
GET	/products/search	Produkte nach Titel, SKU oder Barcode suchen
GET	/products/eligibility	Berechtigung für mehrere Produkte prüfen
POST	/products/register	Ein Produkt für Garantiedeckung registrieren

Kunden

Methode	Pfad	Beschreibung
GET	/customers/orders	Bestellungen eines Kunden abrufen

Registrierung

Methode	Pfad	Beschreibung
GET	/registration/lookup	Eine Registrierung anhand der Nummer nachschlagen

Seriennummern

Methode	Pfad	Beschreibung
POST	/serial-numbers/validate	Eine Seriennummer validieren

Analysen

Methode	Pfad	Beschreibung
POST	/analytics/events	Analyseereignisse des Widgets senden

Konfiguration

Methode	Pfad	Beschreibung
GET / POST	/config	Widget-Konfiguration und Übersetzungen abrufen

Bestellstatus

Methode	Pfad	Beschreibung
GET	/order-status	Den Status einer Bestellung abrufen

POS

Methode	Pfad	Beschreibung
GET	/pos/customer-search	Kunden im POS-Kontext suchen

Shopify-Integration

Methode	Pfad	Beschreibung
GET	/shopify/auth/callback	OAuth-Callback für die App-Installation
POST	/shopify/webhooks	Shopify-Webhook-Ereignisse empfangen
POST	/shopify/post-purchase/sign-changeset	Changesets der Post-Purchase-Erweiterung signieren

Produktsynchronisierung

Methode	Pfad	Beschreibung
POST	/sync-products	Produkte für eine Organisation synchronisieren
POST	/sync-products/all	Produkte für alle Organisationen synchronisieren

Systemstatus

Methode	Pfad	Beschreibung
GET	/health	Den Status der API prüfen

Gibt 200 (fehlerfrei), 206 (eingeschränkt) oder 503 (gestört) zurück.

Verwandte Themen

• Authentifizierung — Einrichtung des API-Schlüssels und Rate Limits
• Garantie-API — Ausführliche Referenz der Garantie-Endpunkte
• Anspruchs-API — Ausführliche Referenz der Anspruchs-Endpunkte
• Policen-API — Ausführliche Referenz der Policen-Endpunkte