Paczka dystrybucyjna zawiera katalog docs/ a w nim pliki HTML z przykładowymi requestami do serwisu. Dowolny przykład może być uruchomiony z poziomu przeglądarki WWW:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
<body> <script> var http = new XMLHttpRequest(); var url = 'http://127.0.0.1:3050/paragon'; var params = { lines : [ { na: "Towar 1", il: 1.0, vt: 0,pr: 2350}, { na: "Towar 2", il: 1.0, vt: 0,pr: 1150} ], summary : { to: 3500 } }; http.open('POST', url, true); //Send the proper header information along with the request http.setRequestHeader('Content-type', 'application/json'); http.onreadystatechange = function() {//Call a function when the state changes. //alert(http.responseText); if(http.readyState == 4 && http.status == 200) { alert(http.responseText); } } http.send(JSON.stringify(params)); </script> </body> |
Należy pamiętać że czasem ustawienia przeglądarki mogą blokować tego typu requesty:
- Dostosuj poziom zabezpieczeń w ustawieniach przeglądarki WWW,
- Upewnij się że strona działająca po https:// wysyła requesty do serwisu po https:// (standardowo na porcie 3051)
- Używając certyfikatów “self signed” (czyli np. dostarczonych w paczce instalacyjnej w katalogu /cert), należy w przeglądarce WWW potwierdzić ręcznie ich autentyczność. Poniższy opis opisuje jak to zrobić w przeglądarce Firefox
INTERFACE
Każda paczka dystrybucyjna zawiera definicję RESTful API zgodną z notacją OpenAPI 3.0.3 . Aktualną definicję można również pobrać z github.com (https://github.com/bigdotsoftware/posnetserver)
Potwierdzenie autentyczności certyfikatów SSL
Przykład dla przeglądarki Firefox:
- Otwórz “Options”
- Z lewego menu należy wybrać “Privacy & Security”
- Kliknij “View Certificates”
- W zakładce “Authorities” zaimportować certyfikat (Screenshot #1)
- W zakładce “Servers” wybrać “Add Exception” (Screenshot #2)
- W polu “Location” wpisać https://localhost:3051
- Klikamy “Get Certificate” (PosnetServer musi być uruchomiony) i następnie “Confirm Security Exception”
- Od teraz można już używać połączenia SSL w Firefox (przykład: /docs/paragon_ssl.html)