JTL REST API - appRegistration / erste Einrichtung

Benjamin S.

Gut bekanntes Mitglied
7. September 2021
100
23
Hallo zusammen,
Die Open Beta der REST API wurde heute morgen ja veröffentlicht.
Gibt es schon eine Doku über die Scopes etc. bei der appRegistration?
In der Doku ist es als "todo" markiert: https://wawi-api.jtl-software.com/#tag/appRegistration/operation/Authentication_RegisterAppAsync

Ich bin also quasi bei step 4 in der Anleitung hier: https://guide.jtl-software.com/jtl-wawi/jtl-wawi-api/jtl-wawi-api-nutzen/

Und ohne die API tokens komme ich natürlich nicht an die anderen API Endpoints dran, ich hier überall den X-API token etc. brauche.
 

Shopküche.de

Offizieller Servicepartner
SPBanner
Die Scopes müssen als Array übermittelt werden:

Code:
{
    "AppId": "myApp/v3",
    "DisplayName": "My App",
    "Description": "Demo app for testing purposes",
    "Version": "3.0.0",
"AppIcon": "iVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAYAAABXAvmHAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAABS5JREFUeNrsmjtIdUcQx/dej+834gPRKKZQMAhipzZWSZE0pkmRwiK9IWkEhVgEUikBC4tUooXBKulCCBhiYZUmhY0aRWN84Bvfr+xvcQ/nnru755wgxEscGK73njkz85+dmZ3d70s9PT2JXKa0yHF6A/BfU6qnpyf4vVZyt+QPJD+8wmD/IXlR8ob+0Xv+LJE8KvlTye+88qD/KflzyT/yJa+xsTElP796BlCZA1lTLfljyZeSf2dZPpL8RY6lfoHkbyQ3es/LURz3zfv7e/H4+JhZSKmUyMvLU7+Hn9kI+XQ6rfSF9yJ+9zwvDohepN6L6zyGampqRFFRkW8U53H69PRUFBcXK44CwTvn5+fi5uZG1NbWKjBaH85fXV2Js7MzpQdZB30IgIq4ADA4NDQk+vr6fCe1M1NTU2JgYED09/erqEYBmJ+fF8vLy2J8fFxUV1f7+oj80tKSmJ6eVkAA5AhoqyeVPZlQ2n5raWkRbW1tWcAqKipEc3OzaG1tjRWMuro6UVJSItrb20VZWVnGs83NTQWElYFt9PDw8AiAOPnmR8cU3dvbWwVOKoxdhTo97u7uTI4pWxqEA4DwdAHGLTxbTvKM2ohLhYWFTrukjmZbVqjgJ10BV7qtrq6KyspKZbSjoyNL9uLiQmxsbKiC3dnZsdrVXSi8AkF9uug9Lewaq/WLyJmKCiMs5+zsrFhYWBDl5eVibm4uC8D6+roYGxtTaUiBUku2gKAzKoX8FQi2MRcAVwrxO44RZVtkAXl5eenvJTbntE9RRayCqlMozsHGpYxn+fn5Shf5bUsN6gQAsAuAqQuFUyhyBcLRxkFTCiGnU9EVtXDDiJJzpZBfA0kARHWhOHmrn2EP0K4acAUjURHHAYAOVshlVNsK1pRNLioYeh9JtA/Y2mjQqDYcR0fSGghmRUYNIBwcwFxpEgeAbX4JBgsHbPpcALICgjG6RpwxWOetiUgfvbsWFBRYQfKMdsrfvBMlZwKgJ2AFlDnm6OgoowZsBX19fW2cXZBnIkUPBk0yEL8fHx/7bTQ4hYZnK3Sx2bkAqFmIjWVra8vZLvULzOjImwDs7+8rPRisqqqyjuPI4DxgmEJNALCxvb2tPl0phF1PV7TeKUtLS9WM3tvbmyHM7DI8PKxWwdYV9LK60lHLRZ3egvqco0SwaPmEOVUBJEh8j5pLgvyScokvtkw18FrvUN+uFl8lAFve0d5sB/aoXE1CFC9dCnt8utLXM+W6yUkO7Z2dnaKhocE6678UMXJz3cLBCH84Y9j0e+EoIsgdT5hQNjIyojYfU8To2S+1Ct3d3WJiYkI5f3BwICYnJ9VpzrTDe6ZT1cnJifUqxBZ9NjLXHU4SYrVhqL6+3nlZljbtlhy8kxDybP0vBSBIbJyuDS9tKkRuzNbW1mJfN87MzGSlj+3wb5o6/+0Ir1MowxJ5tru7K0ZHR8Xg4KDo6upSeQ/jAAMWq0SdrKysqGvAxcVF32E9SpC7QRDMVwxyQefpMKQeKWiKMvbQQ1pbQKT4F5q/uKY2DVRc/dENGJPpDDiEUQzS4g4PDxUQ/SwY/aampixn0Lm3t+evHMGirmwnQvRgBxD69i9EvwDgO/nHZ7Z+jLMoD17mhs+ttsnT5FDwDIDeqD6PHd6xrMA0KfSDDUD4ai8J2a5Wws7ZDj8x6Ezy93j3m+Sfc3CK+FryrwBg1/pE8rc54vjts69TwY3sSPKXIJL8vuR3KYFX5ji+zkv+SfLfktW8k3r7vxJvAP7nAP4RYACGIpOPAAgzRQAAAABJRU5ErkJggg==",
    "ProviderName": "JTL-Software-GmbH",
    "ProviderWebsite": "https://www.jtl-software.de",
    "MandatoryApiScopes": ["all.read"],
    "OptionalApiScopes": []
}
 
  • Gefällt mir
Reaktionen: Benjamin S.

Benjamin S.

Gut bekanntes Mitglied
7. September 2021
100
23
@Shopküche.de
Danke für die Antwort, das mit den Arrays macht Sinn.

Die Verbindung hat über die Swagger UI bei mir nicht funktioniert, über python aber ganz normal. Nur falls jemand das gleiche Problem hat.
 

Benjamin S.

Gut bekanntes Mitglied
7. September 2021
100
23
Ich würde empfehlen mit Postman zu arbeiten: https://www.postman.com/
Über die Doku kann man die API-Spezifikationen herunterladen und in Postman importieren. So ist es leichter erstmal die App zu registrieren und die Endpoints zu testen.
Danke für den Tip, Postman macht das ganze echt leichter.

Noch eine Frage allerdings:
Seid ihr in der Lage POST calls zu machen?

GET funktioniert bei mir wunderbar nur bei POST calls bekomme ich einen 401 zurück:
https://forum.jtl-software.de/threads/jtl-api-post-nicht-moeglich-401-unauthorized.213922/
 

juergenl

Aktives Mitglied
26. Februar 2020
11
3
Viele GET Befehle funktionieren mit der Authorisierung read.all während für Post jeweils der entsprechende Scope laut Dokumentation angemeldet werden muss. Also zum Beispiel "MandatoryApiScopes": ["all.read", "salesorder.createsalesorder"]
 
  • Gefällt mir
Reaktionen: Benjamin S.

Benjamin S.

Gut bekanntes Mitglied
7. September 2021
100
23
Viele GET Befehle funktionieren mit der Authorisierung read.all während für Post jeweils der entsprechende Scope laut Dokumentation angemeldet werden muss. Also zum Beispiel "MandatoryApiScopes": ["all.read", "salesorder.createsalesorder"]
Danke für die schnelle Antwort.

Wo findest du in der API denn die Namen der einzelnen scopes?
Hier z.B. kann ich nirgendwo den nötigen scope einsehen:
https://wawi-api.jtl-software.com/#tag/stock/operation/Stock_QueryStocksPerItemAsync

edit:

Folgender scope hat nun funktioniert, danke noch einmal :)
["stock.stockadjustment"]
 
Zuletzt bearbeitet:

TiK

Mitglied
19. September 2022
16
5
Hallo zusammen, also nochmal zum Mitmeißeln, kann man die Scopes irgendwo nachlesen?
Danke!
 

juergenl

Aktives Mitglied
26. Februar 2020
11
3
Bei jedem Endpoint kommt direkt oben nach der Beschreibung ein Punkt AUTHORIZATIONS: > den man aufklappen muss. Dann sieht man welche Rechte notwendig sind. Alle benötigten müssen bei der App-Registrierung in das Array mit den "MandatoryApiScopes": ["all.read",""customer.querycustomernotes "], eingetragen werden.
 
Zuletzt bearbeitet:
  • Gefällt mir
Reaktionen: TiK
Ähnliche Themen
Titel Forum Antworten Datum
Neu JTL-Connector Token Onlineshop-Anbindung 0
Neu JTL SHOP 4 Vorlagenproblem Einrichtung von JTL-Shop4 0
Neu JTL Paypal Checkout Button bei Konfigurationsartikel verhindern Plugins für JTL-Shop 1
Neu JTL SHOP update von 5.2.4 auf 5.3.1 - DBupdater startet nicht das Datenbankupdate Installation / Updates von JTL-Shop 6
Neu 👉 JTL-Wawi 1.9 Open Beta Release - Aktuell 1.9.4.0 Releaseforum 1
Neu JTL PayPal: Plugin - Bestellungen werden nicht angezeigt. Fehlermeldung "Unable to load config 'file:.conf'" Plugins für JTL-Shop 2
Neu JTL-WMS Mobile Artikelname wird nicht mehr vollständig angezeigt JTL-WMS / JTL-Packtisch+ - Fehler und Bugs 0
Evo Slider in JTL Shop 5.3.1 Einrichtung JTL-Shop5 0
Artikelbeschreibung standardisiert von JTL-Wawi ziehen - Positionsname JTL-Wawi 1.8 11
Neu JTL 5, Footerdesign, Boxabstände und Ausrichtung korrigieren Gelöste Themen in diesem Bereich 5
Neu JTL Search funktioniert nicht seit Shopupdate auf 5.3.1 JTL-Shop - Fehler und Bugs 0
Neu JTL Shipping inaktiv User helfen Usern - Fragen zu JTL-Wawi 1
JTL Shop Kreditkartenzahlung erneut an Kunden senden Allgemeine Fragen zu JTL-Shop 0
Neu JTL Shop in Safari zeigt Feld falsch an. JTL-Shop - Fehler und Bugs 0
Neu JTL <-> Shopware 6 - Maximale Anzahl von Kundengruppen? Shopware-Connector 4
Neu Datenmigration von anderer WaWi auf JTL-WaWi Starten mit JTL: Projektabwicklung & Migration 12
Neu Bestseller-Templates AVIA, CLEARIX, FIRE - schnell, universell, 100% kompatibel zum JTL-Shop Templates für JTL-Shop 1
Beschaffung Bestandsplanung in JTL Wawi 1.8.10 JTL-Wawi 1.8 0
Neu Mindestbestellwert für Netto-Einkaufswert JTL-Shop 5 Allgemeine Fragen zu JTL-Shop 0
Neu Artikel von JTL mit Ebay verbinden in Easy Action Einrichtung und Installation von JTL-eazyAuction 2
Neu automatisierte Kundenbestellungen (Anbindung JTL/Kanban) Schnittstellen Import / Export 1
Neu JTL POS wird nicht an WaWi angebunden Einrichtung / Updates von JTL-POS 2
JTL 1.7 Bestimmte reservierte Produkte sollen keinen Einfluss auf Bestand haben JTL-Wawi 1.7 0
Neu JTL Shop 5 Daten - In "leere" JTL Wawi Datenbank importieren - Ist das möglich? User helfen Usern - Fragen zu JTL-Wawi 8
Kaufland JTL Erfahrung? kaufland.de - Anbindung (SCX) 0
Neu Frage zu Designvorlage JTL-Adept - Slider (für Ebay) eBay-Designvorlagen - Fehler und Bugs 4
Neu ecomdata down? Hosting JTL Wawi nicht erreichbar User helfen Usern - Fragen zu JTL-Wawi 46
Neu Packliste JTL 1.8 Variablen User helfen Usern - Fragen zu JTL-Wawi 0
Kennzahlen Übersicht für JTL Wawi - Wirtschaftliche Auswertung JTL-Wawi 1.8 0
Nach Aufruf von Stored Procedure 'Kunde.spKundeUpdate' schwere Fehler in JTL (z.B. Kundenliste, Workflow-Editor) JTL-Wawi 1.8 2
[JTL-WAWI API] MandatoryApiScopes / OptionalApiScopes JTL-Wawi 1.8 3
Neu Migration Shopware 5 auf 6 mit JTL-Wawi ohne Datenverlust Shopware-Connector 1
Neu JTL-Shop 5 Liste von CSV-Export Variablen gesucht Allgemeine Fragen zu JTL-Shop 1
Neu Datenimport über Ameise in JTL für Shopware Shopware-Connector 1
Neu Datenumzug von Xentral ERP Software auf JTL-Wawi Schnittstellen Import / Export 4
Neu JTL Packtisch - offene Bestellungen Arbeitsabläufe in JTL-WMS / JTL-Packtisch+ 5
2 JTL-Shops = unterschiedlicher SEO-URL-Stamm nötig JTL-Wawi 1.8 5
Neu Suche Download JTL WAWI 1.3.20.0 User helfen Usern - Fragen zu JTL-Wawi 8
[JTL-WAWI API] Bestellung mit Stücklistenartikel JTL-Wawi 1.8 5
Neu Artikel nach Übertragung von JTL auf geplant im Jahr 2030 WooCommerce-Connector 2
Neu JTL Übertragung zu Shopify funktioniert nicht Shopify-Connector 0
Neu JTL-Wawi 1.9 Open Beta User helfen Usern - Fragen zu JTL-Wawi 6
Neu IonCube bei JTL Hosting? Allgemeine Fragen zu JTL-Shop 2
Neu zweiten Shop auch bei JTL hosten ? Allgemeine Fragen zu JTL-Shop 1
Neu Error Code = 0 bei Installation JTL-Shop 5.3.1 Einrichtung JTL-Shop5 3
Neu Angriff auf JTL-Shop ?Log file: Wrong ip Allgemeine Fragen zu JTL-Shop 2
Anfrage für Zusammenarbeit zur Verbesserung unseres JTL-Onlineshops Einrichtung JTL-Shop5 1
Gelöst JTL-POS: Rechnung über Kasse Allgemeine Fragen zu JTL-POS 3
Neu JTL Wawi [1.5.33] Startet nicht mehr JTL-Wawi - Fehler und Bugs 8
Gelöst Ausgabe Kundengruppenattribute JTL-Shop 5.3 Allgemeine Fragen zu JTL-Shop 0

Ähnliche Themen