IWS/Dokumentation/Serviceübersicht (IWS3)
Aus ITscope GmbH - Wissensbasis
< IWS | Dokumentation
1 ITscope Web Service Version 3 (IWS3) Serverzugänge
Die IWS Version 3 bietet 5 verschiedene Servicetypen an, die sich in der Art der Anfragekodierung und dem Ergebnisformat unterscheiden.
- Der soap/IWS3Public akzeptiert SOAP-Requests gemäß der IWS WSDL und liefert SOAP-Responses. Sie benötigen dafür also einen SOAP-Client zum Verarbeiten der Daten. Testen Sie die Soap Web Services zum Beispiel per http://www.soapui.org.
- Der xslt-Service nimmt per HTTP POST XML-Requests entgegen und liefert entsprechende Responses. Alternativ können die Anfrageparameter auch über URL kodiert werden und per HTTP GET zum Server geschickt werden (mit einem HTTP-Client, z.B. ein normaler Webbrowser). Der Service kann Daten auch vor der Auslieferung transformieren, so daß aus XML-Antworten auch HTML oder andere Formate entstehen können.
- Der csv-Service unterscheidet sich von der Anfragekodierung nicht vom xslt/method Service, liefert die Daten aber in tabellarischer Form zurück.
- Der rest-Service ist ein reiner XML Service, Parameter werden per URL kodiert übergeben. Eine Transformation der Daten während des Ausgabevorgangs ist nicht möglich.
- Der soap/BmecatService ist eine BMEcat-SOAP Web Service über HTTP. Hierzu ist eine CatalogueRequest-Anfrage analog zum IWS3Public/productLookup möglich, der Service liefert das Ergebnis dann im BMEcat-Format (dies läuft nicht über ITscope-Datenprofile wie alle anderen Produktabfragen)
2 Serviceübersicht
| Servicename | Beschreibung | Server, Basis-URL | HTTP POST (SOAP/XMLRPC) | HTTP GET (REST Style) | Resultat |
|---|---|---|---|---|---|
| soap/IWS3Public | Standard-Web Service über HTTP | http://iws.itscope.de/soap/IWS3Public | derzeit nur SOAP, Plain XMLRPC in Arbeit | Nein | SOAP |
| soap/BmecatService | BMEcat-SOAP Web Service über HTTP | http://iws.itscope.de/soap/BmecatService | derzeit nur SOAP, Plain XMLRPC in Arbeit | Nein | SOAP |
| xslt/method | XML-Service mit optionaler Datentransformation via XSLT | http://iws.itscope.de/xslt/method | Nein | Ja, Parameter URL-kodiert | XML oder transformiert, optional gezippt |
| rest/method | reiner XML-Service inkl. BMEcat | http://iws.itscope.de/rest/method | Nein | Ja, Parameter URL-kodiert | XML |
| csv/method | Service für Daten in tabellarischer Form (CSV, Excel) | http://iws.itscope.de/csv/method | Nein | Ja, Parameter URL-kodiert | CSV, Excel, optional gezippt |
Anmerkung: "method" wird durch den entsprechenden Methodennamen ersetzt,
z.B. http://iws.itscope.de/xslt/productLookup statt http://iws.itscope.de/xsltService?method=productLookup
Bei Abfragen über SOAP muß der SOAPAction-Header gesetzt werden: z.B. "SOAPAction: accountAction"