This is an old revision of the document!
GetToken() metod
Akcija
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).
Sintaksa
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
| Naziv | Vrsta | Opis | Revizija |
|---|---|---|---|
| companyCode | String | 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. | 19-6-11 |
| userName | String | 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 | Korisnička lozinka dodeljena korisniku prilikom otvaranja naloga u Balans ERP-u. | 19-6-11 |
| sessLen | Integer | 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 |
gettoken (RESTful)
RESTful metod analogan GetToken() metodi.
| HTTP Metod | Primer URLa | Revizija |
|---|---|---|
| GET | http://<server>/rs/login/gettoken?id=<>&pwd=<>&len=<>&usr=<>&cust=<> | 19-6-11 |
Parametri
| Parametar | Tip | Opis | Revizija |
|---|---|---|---|
| id | String | Korisnički nalog provajdera (obavezan) =userName | 19-6-11 |
| pwd | String | Šifra provajderskog naloga (obavezan) =userCode | 19-6-11 |
| len | Integer | (opciono) Pozitivan ceo broj izmedju 1 i 480. Podrazumevana vrednost je 10. predstavlja dužinu važenja tokena u minutama =sessLen | 19-6-11 |
| usr | String | (opciono) Balans korisnički nalog koji obavlja operacije, Kada nedostaje, jednak je vrednosti id parametra =authUser | 19-6-11 |
| cust | String | (opciono) B2B nalog komitenta za čiji račun usr obavlja operacije =authCustomer | 19-6-11 |
Rezultat
| 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 |