kb:ws:autorizacija_gettoken

This is an old revision of the document!


GetToken() metod

Dobijanje session token jedinstvenog broja koji se koristi pri pozivu metoda koje prikazuju ili menjanju podatke sistema. Rezultat funkcije je String vrednosti koja sadrži kod sesije koji treba koristiti u narednim pozivima metoda koji se obraćaju bazi podataka.

Poziv metode sadrži osetljive podatke, korisničku lozinku, pa je preporuka da se za transportni protokol koristi https (TSL).

GetToken (companyCode, userName, userCode, sessLen, [authUser], [authCustomer])

String sessToken; Niz karaktera, određenog roka trajanja, koji jedinstveno identifikuju korisnika i sesiju u kojoj radi.

NazivVrstaOpisRevizija
companyCodeStringZa 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.19-6-11
userNameStringKorisnič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
userCodeStringKorisnička lozinka dodeljena korisniku prilikom otvaranja naloga u Balans ERP-u.19-6-11
sessLenIntegerBroj 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
authCustomerString(Opciono)Korisnički nalog, identifikovanog od strane provajdera, Balans komitenta (kupca ili dobavljača).19-6-11
authUserString(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


gettoken (RESTful)

RESTful metod analogan GetToken() metodi.

HTTP MetodPrimer URLaRevizija
GEThttp://<server>/rs/login/gettoken?id=<>&pwd=<>&len=<>&usr=<>&cust=<>19-6-11
ParametarTipOpisRevizija
idStringKorisnički nalog provajdera (obavezan) =userName19-6-11
pwdStringŠifra provajderskog naloga (obavezan) =userCode19-6-11
lenInteger(opciono) Pozitivan ceo broj izmedju 1 i 480. Podrazumevana vrednost je 10. predstavlja dužinu važenja tokena u minutama =sessLen19-6-11
usrString(opciono) Balans korisnički nalog koji obavlja operacije, Kada nedostaje, jednak je vrednosti id parametra =authUser19-6-11
custString(opciono) B2B nalog komitenta za čiji račun usr obavlja operacije =authCustomer19-6-11
HTTP kodOpisRevizija
200 OKDobija se token u formi application/json, npr. {“token” : “1712201622047865”} 19-6-11
401 Not AuthorizedDobija se tekst greške u application/json zapisu19-6-11
500 Server ErrorBilo koji drugi tip greške u application/json zapisu19-6-11


  • kb/ws/autorizacija_gettoken.1577193579.txt.gz
  • Last modified: 2019/12/24 13:19
  • by aleksandar