Vor dem API-Aufruf
Authentifizierung
Prüfen Sie die Authentifizierung.
Verfügbar ab
Prüfen Sie, ob der Shop-Tarif die benötigte API-Funktion enthält.
Erforderliche Berechtigungen
Prüfen Sie die Schlüsselberechtigungen und die Bedingungen für die gesendeten Felder.
Welcher Tarif wird benötigt
| Verfügbar ab | Beschreibung |
|---|---|
| BASIC | BASIC umfasst das Lesen von Bestellungen und Kundenvorgängen, deren Statusänderung, Änderungen des Zahlungsstatus sowie des gespeicherten Erstattungsbetrags. |
| STANDARD | Katalog-, CMS-, Such- und Lageroperationen erfordern STANDARD oder höher. |
Bereits abonnierte Shops erhalten die API-Funktionen ihres Tarifs.
Berechtigungen für eine Operation
- Die Referenz nennt required_scopes jeder Operation sowie conditional_scopes für zusätzlich geschützte Felder oder Änderungen.
- Leserechte erlauben nicht automatisch das Erstellen, Bearbeiten oder Löschen.
- Token-Ausstellung und Kontext erfordern weiterhin Authentifizierung, auch wenn kein Ressourcenrecht aufgeführt ist.
Auflisten
GET/api/v1/products
- Authentifizierung
Bearer- Verfügbar ab
- STANDARD
- Erforderliche Berechtigungen
catalog.product:read
Aktualisieren
PATCH/api/v1/products/{product_id}
- Authentifizierung
Bearer- Verfügbar ab
- STANDARD
- Erforderliche Berechtigungen
catalog.product:update
Wann zusätzliche Berechtigungen nötig sind
Aktualisieren
PATCH/api/v1/products/{product_id}
- Authentifizierung
Bearer- Verfügbar ab
- STANDARD
- Erforderliche Berechtigungen
catalog.product:update- Zusätzliche Berechtigungen für bestimmte Felder
- Wenn variant_value_ids enthalten ist:
catalog.product_variant:create,catalog.product_variant:update,catalog.product_variant:delete - Wenn variants_enabled enthalten ist:
catalog.product_variant:update
- Wenn variant_value_ids enthalten ist:
Was bei einem Tarifwechsel geschieht
Entfällt ein Recht durch einen Tarifwechsel nach unten, wird es aus den API-Schlüsseln entfernt und im Administrationsbereich abgewählt und deaktiviert.