This is an old revision of the document!
Generisanje tokena
Generisanje sesijskog tokena koji se koristi pri pozivu metoda koje prikazuju ili menjanju podatke sistema.
REST
POST https://ws.melany.rs/api/rest/auth
| Naziv | Tip | Obavezno | Opis | Revizija |
|---|---|---|---|---|
| username | String | Obavezno polje | Korisničko ime koje se koristi za autentifikaciju. | 24-11-13 |
| password | String | Obavezno polje | Korisnička lozinka dodeljena korisniku prilikom otvaranja naloga. | 24-11-13 |
| duration | Integer | Nije obavezno polje | Trajanje autentifikacijskog tokena se izražava u minutama. Ako nije specificirano ili je vrednost postavljena na 0, podrazumevano vreme trajanja tokena je 24 časa. | 24-11-13 |
| company | Integer | Obavezno polje | Identifikator kompanije ili entiteta koji zahteva autentifikaciju. | 24-11-13 |
Rezultat
| Naziv | Tip | Opis |
|---|---|---|
| code | String | Niz karaktera, određenog roka trajanja, koji jedinstveno identifikuju korisnika i sesiju u kojoj radi. |
| expires | Date | Datum i vreme istak tokena prema postavljenom parametru “duration”. |
Primeri
REST Zahtev
POST https://ws.melany.rs:8191/LogIn/LogIn HTTP/1.1
Accept-Encoding: gzip,deflate
Content-Type: text/xml;charset=UTF-8
SOAPAction: ""
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.bort.com/">
<soapenv:Header/>
<soapenv:Body>
<ser:GetToken>
<companyCode>1</companyCode>
<userName>Nalog</userName>
<userCode>sifra_naloga</userCode>
<sessLen>20</sessLen>
<authCustomer>nalog_komitenta</authCustomer>
<authUser>balans_nalog</authUser>
</ser:GetToken>
</soapenv:Body>
</soapenv:Envelope>
Odgovor
HTTP/1.1 200 OK
Server: GlassFish Server Open Source Edition 4.1.2
X-Powered-By: Servlet/3.1 JSP/2.3 (GlassFish Server Open Source Edition 4.1.2 Java/Oracle Corporation/1.8)
Server: grizzly/2.3.23
Content-Type: text/xml; charset=utf-8
Transfer-Encoding: chunked
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:GetTokenResponse xmlns:ns2="http://services.bort.com/">
<return>20010110091424109009</return>
</ns2:GetTokenResponse>
</S:Body>
</S:Envelope>
REST
Zahtev
https://ws.melany.rs:8191/BortApp-war/rs/login/gettoken?id=balans_username&pwd=balans_password&len=30
Napomena: Ukoliko username ili password sadrže komandne karaktere URL-a (&,+,=) neophodno ih je zameniti ANSI kodom.
| Karakter | Kod |
|---|---|
| + | %2B |
| & | %26 |
| = | %3D |
Odgovor
| HTTP kod | Opis | Revizija |
|---|---|---|
| 200 OK | Dobija se token u formi application/json, npr. {“token” : “1712201622047865”} | 19-6-11 |
| 401 Not Authorized | Dobija se tekst greške u application/json zapisu | 19-6-11 |
| 500 Server Error | Bilo koji drugi tip greške u application/json zapisu | 19-6-11 |