Swisstrusty Artikel anpassen
REST-API Schnittstelle JSON
Entwickler - Home
Order-Übermittlung an Promail (Json API)
Order auslesen (Versand, Wareneingang und Retouren) mit Tracking (Json API)
Order löschen (Json API)
Stock/Lager auslesen (Json API)
Retouren auslesen (Json API)
Artikel auslesen (Json API)
Neuer Artikel erfassen (Json API)
Artikel anpassen (Json API)
Delivery/Wareneingang-Übermittlung an Promail (Json API)
Delivery/Wareneingang aus Rework (Json API)
Booking without order (Json API)
Swisstrusty Artikel anpassen (Json API)

Überblick "Swisstrusty Artikel anpassen"-api

Promail REST API 2.0 ist ein einfacher Wege um Daten mit der Promail Plattform auszutauschen und zu bearbeiten. Mit dem ArticleNew-API können neue Artikel an Promail übermittelt werden.

Mit diesem API können die Artikeldaten angepasst werden, welche für eine Listung auf www.swisstrusty.ch notwendig sind.
Der UVP ist der normale Verkaufspreis (Listenpreis)
Der Price ist der aktuelle Verkaufspreis (eventuell Aktionspreis)
Jeder Artikel benötigt midestens ein Bild und eine url zum Webshop des Artikels

Basis HTTP

Das API ist HTTP-basiert. Das heisst das API kann mit HTTP Bibliotheken wie cURL oder urllib genutzt werden. Dadurch kann das API direkt im Browser genutzt werden.

Host url

Anfragen können an die url https://www.deal1.ch/PromailRESTswisstrusty_skuV1.php geschickt werden.

Json

Die Abfragen sind in der JavaScript Sprache "Json" an das API zu schicken. Beispiele unten.

POST

Das API reagiert auf die API Send-Methoden und steuert unterschiedliche Funktionen an.
Die Methode POST wird verwendet um Daten wie "neue Artikel" an Promail zu übermitteln.

Zugriffsschlüssel und API_Name

Um das API verwenden zu können, müssen die korrekten Zugriffsschlüssel und der gewünschte API-Name im API-Aufruf enthalten sein.
Das API verwendet 3 Schlüssel, welche beim API-Aufruf übergeben werden.
"Key" = x6R38e94z721GtUp (der Key steht in Bezug zu ihrem Promail-Konto).
"PrivatKey" = Muss bei Promail beantragt werden.
"Your_Email" = Die Emailadresse ihres Hauptkontos. Promail erteilt ihnen gerne Auskunft.
Mit "API-Name" wird die entsprechende Schittstelle ausgewählt.
Partner/Kunden erhalten die Zugriffsschlüssel durch Anfrage-Mail an office@promail-ag.ch.

POST Swisstrusty Article übermitteln

Im folgenden PHP-Beispiel-Code werden 2 Artikel mit cURL übermittelt:
//API Url $url = 'https://www.deal1.ch/PromailRESTswisstrusty_skuV1.php'; //Initiate cURL. $ch = curl_init($url); //The JSON data. $jsonData = '{ "partner": { "key": "x6R38e94z8721GtUp", "privatkey": "abc", "your_email": "vincent.jeppesen@jeppesen.ch", "api_name": "swisstrusty_sku", "skus": [ { "sku": "2234", "name":"AAA Shirt", "specification": "XXS blue", "image": "https://test.deal1.ch/jeppesen/66041.jpg", "image1": "https://test.deal1.ch/jeppesen/66042.jpg", "image2": "https://test.deal1.ch/jeppesen/66043.jpg", "image3": "https://test.deal1.ch/jeppesen/66044.jpg", "image4": "https://test.deal1.ch/jeppesen/66045.jpg", "price": "15.50", "uvp": "19.50", "swisstrusty": "y", "category": "Essen", "gender": "Alle", "shopurl": "https://www.shopify.com/Produkte...." },{ "sku": "2277", "name":"BBB Shirt", "specification": "XXS red", "image": "https://test.deal1.ch/jeppesen/66041.jpg", "image1": "https://test.deal1.ch/jeppesen/66042.jpg", "image2": "https://test.deal1.ch/jeppesen/66043.jpg", "image3": "https://test.deal1.ch/jeppesen/66044.jpg", "image4": "https://test.deal1.ch/jeppesen/66045.jpg", "price": "15.50", "uvp": "19.50", "swisstrusty": "y", "gender": "Alle", "shopurl": "https://www.shopify.com/Produkte...." } ] } }'; //Tell cURL that we want to send a POST request. curl_setopt($ch, CURLOPT_POST, 1); //Attach our encoded JSON string to the POST fields. curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData); //Set the content type to application/json curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json')); //Execute the request $result = curl_exec($ch); //Get Status Code $httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); echo 'HTTP code: ' . $httpcode;

Erklärungen

Der Beispielcode passt zwei Datensätze für zwei Artikel an. Auf diese Art können bis zu 50 Datensätze angepasst werden.

Fehlermeldungen+Erfolgsmeldungen

Bei einem erfolgreichen Aufruf des API's wird ein http-status 200 gesendet.
Wenn der Aufruf nicht erfolgreich war, wird ein http-status 401 gesendet.
Folgende Fehlermeldungen sind möglich: