GSD NET-Sxp Sample requests guide
You're able to execute request to NET-sxp using cURL. cURL is a free, open-source software used to transfer data using Internet Protocols for the given URL. You can execute requests using command line in windows operation system or execute it in your own application. The way of using cURL on your own application, depends on technology which you use to create your app. Below you can see sample requests to NET-sxp webservice. You can just pass those commands to the command prompt in operation system, set the values and then run.
CURL documentation
api/v1/login/via-token/:token
First you should obtain JWT token. To get valid JWT token for given SXP endpoint you should provide token set in NET-sxp endpoint configuration. In the response you get JWT, so you will be able to call execute macro requests
1 | curl -XPOST -H "Content-type:application/json" "http://localhost:8080/api/v1/login/via-token/tokenFromNETsxpConfig"
|
/api/v1/execute/:macro
After obtaining JWT token, you can call execute macro requests e.g. get articles list from the ERPframe
1 | curl -XPOST -H "Content-type:application/json" -H "Authorization:Bearer yourJWTToken" -d "[ {\"name\":\"artikelids\", \"type\": \"C\", \"value\": \"1713\"} ]" "http://localhost:8080/api/v1/execute/GETARTIKELDATEN"
|
api/v1/_CheckService
Call _CheckService
to validate NET-sxp installation
1 | curl -XGET "http//localhost:8080/api/v1/_CheckService"
|
Axios
Below you can see sample JavaScript code to make a HTTP request using axios library. Axios allow programmer to make a HTTP request both from the browser and node.js application.
Axios documentation
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | const config = { headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer yourJWTToken' } }; axios.post('http://localhost:8080/api/v1/execute/GETARTIKELDATEN', [{"name":"artikelids", "type": "C", "value": "1713"}], config) .then(function (response) { console.log(response); }) .catch(function (error) { console.log(error); }) .finally(function () { }); |