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 | Vrsta | Opis | Revizija |
|---|---|---|---|
| username | String, obavezno za SOAP | Za sada se ne koristi, slati prazan string. Jedinstvena šifra firme kojoj se pristupa. Šifra se dobija prilikom instaliranja modula za pristup ERP-u preko web servisa. Nepromenjiva je i jedinstvena za svaku firmu sa kojom se radi. REST verzija servisa nema ovaj parametar. | 19-6-11 |
| userName | String, obavezno | Korisnički nalog iz Balans ERP-a pod kojim se vrše operacije nad API-jem. Nalog otvara administrator Balnas ERP-a i tom prilikom postavlja privilegije koje nalog ima. Aktivnosti sa weba biće vezane za ovaj nalog. | 19-6-11 |
| userCode | String, obavezno | Korisnička lozinka dodeljena korisniku prilikom otvaranja naloga u Balans ERP-u. | 19-6-11 |
| sessLen | Integer, obavezno | Broj minuta koliko će sesija biti otvorena. Broj mora biti između 1 i 480. Nakon isteka ovog perioda korisnik mora zahtevati novi session token. | 19-6-11 |
| authCustomer | String, opciono | Korisnički nalog, identifikovanog od strane provajdera, Balans komitenta (kupca ili dobavljača). | 19-6-11 |
| authUser | String, opciono | Korisnički nalog Balans korisnika u čije ime se vrše operacije (za potrebe ekstenzija Balans ERP-a, npr. mobilna prodaja, sindikalna prodaja, servisiranje itd.) Ukoliko parametar nedostaje ili je džoker-znak (%), uzima se vrednost parametra userName, što znači da mora da postoji isti korisnički nalog (ne ime i prezime) korisnika u Balansu | 19-6-11 |
SOAP
GetToken (companyCode, userName, userCode, sessLen, [authUser], [authCustomer])
Rezultat
String sessToken; Niz karaktera, određenog roka trajanja, koji jedinstveno identifikuju korisnika i sesiju u kojoj radi.
Parametri
SOAP
| SOAP naziv | REST naziv | Vrsta | Opis | Revizija |
|---|---|---|---|---|
| companyCode | - | String, obavezno za SOAP | Za sada se ne koristi, slati prazan string. Jedinstvena šifra firme kojoj se pristupa. Šifra se dobija prilikom instaliranja modula za pristup ERP-u preko web servisa. Nepromenjiva je i jedinstvena za svaku firmu sa kojom se radi. REST verzija servisa nema ovaj parametar. | 19-6-11 |
| userName | id | String, obavezno | Korisnički nalog iz Balans ERP-a pod kojim se vrše operacije nad API-jem. Nalog otvara administrator Balnas ERP-a i tom prilikom postavlja privilegije koje nalog ima. Aktivnosti sa weba biće vezane za ovaj nalog. | 19-6-11 |
| userCode | pwd | String, obavezno | Korisnička lozinka dodeljena korisniku prilikom otvaranja naloga u Balans ERP-u. | 19-6-11 |
| sessLen | len | Integer, obavezno | Broj minuta koliko će sesija biti otvorena. Broj mora biti između 1 i 480. Nakon isteka ovog perioda korisnik mora zahtevati novi session token. | 19-6-11 |
| authCustomer | cust | String, opciono | Korisnički nalog, identifikovanog od strane provajdera, Balans komitenta (kupca ili dobavljača). | 19-6-11 |
| authUser | usr | String, opciono | Korisnički nalog Balans korisnika u čije ime se vrše operacije (za potrebe ekstenzija Balans ERP-a, npr. mobilna prodaja, sindikalna prodaja, servisiranje itd.) Ukoliko parametar nedostaje ili je džoker-znak (%), uzima se vrednost parametra userName, što znači da mora da postoji isti korisnički nalog (ne ime i prezime) korisnika u Balansu | 19-6-11 |
Primeri
SOAP
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 |