Zum Hauptinhalt springen

Artikelimport per JSON API

Frage​

Wie kann ich Artikel und Preise automatisiert per API in meinen Konfigurator importieren – z.B. aus meinem ERP- oder PIM-System?

Antwort​

K3 bietet einen API-Endpunkt für den direkten Artikelimport per JSON. So können Sie Artikel und Preise programmatisch aktualisieren.

1. API-Token erzeugen​

Zuerst benötigen Sie einen API-Token zur Authentifizierung:

  1. Wechseln Sie in Ihr Benutzerprofil
  2. Schalten Sie den Entwickler-Modus an
  3. Klicken Sie auf Token erzeugen

→ Anleitung: API-Token erzeugen

2. Konfigurator-ID ermitteln​

Die ID Ihres Konfigurators finden Sie in der URL, wenn Sie den Konfigurator im Editor öffnen:

https://k3.objectcode.de/app/#/admin/apps/3030/...
                                         ^^^^
                                         ID = 3030

3. API-Endpunkt aufrufen​

POST https://k3-api.objectcode.de/api/v1.0/app/{ID}/import/articles/direct

Ersetzen Sie {ID} durch die ID Ihres Konfigurators.

4. JSON-Format​

Das Format der JSON-Daten entspricht dem Artikel- und Preis-Format der Shop-API:

→ Dokumentation: Artikel & Preise

5. Beispiel mit cURL​

curl -X POST "https://k3-api.objectcode.de/api/v1.0/app/3030/import/articles/direct" \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d @artikel.json

API interaktiv testen​

Sie können die API auch interaktiv auf der Swagger-Dokumentation testen:

→ API-Dokumentation öffnen

Siehe auch​