Differences

This shows you the differences between two versions of the page.

--- kb:ws:autorizacija_gettoken [2017/11/20 09:48] – aleksandar
+++ kb:ws:autorizacija_gettoken [2018/10/02 12:47] – [Parametri] aleksandar
@@ Line 1: / Line 1: @@
-__false__
+====== 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, authCustomer)
+===== Rezultat =====
+**String** sessToken; Niz karaktera, određenog roka trajanja, koji jedinstveno identifikuju korisnika i sesiju u kojoj radi.
+===== Parametri =====
+^Naziv^Vrsta^Opis|
+|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.|
+|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.|
+|userCode|String|Korisnička lozinka dodeljena korisniku prilikom otvaranja naloga u Balans ERP-u.|
+|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//.|
+|authCustomer|String|Korisnički nalog, identifikovanog od strane provajdera, Balans komitenta (kupca ili dobavljača).|
+|authUser|String|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|
+\\
+====== gettoken (RESTful) ======
+RESTful metod analogan GetToken() metodi.
+^HTTP Metod^Primer URLa|
+|GET|[[http://<server|http://<server]]>/rs/login/gettoken?id=<>&pwd=<>&len=<>&usr=<>&cust=<>|
+===== Parametri =====
+^Parametar^Tip^Opis|
+|id|String|Korisnički nalog provajdera (obavezan) =userName|
+|pwd|String|Šifra provajderskog naloga (obavezan) =userCode|
+|len|Integer|(opciono) Pozitivan ceo broj izmedju 1 i 480. Podrazumevana vrednost je 10. predstavlja dužinu važenja tokena u minutama =sessLen|
+|usr|String|(opciono) Balans korisnički nalog koji obavlja operacije, Kada nedostaje, jednak je vrednosti id parametra =authUser|
+|cust|String|(opciono) B2B nalog komitenta za čiji račun usr obavlja operacije =authCustomer|
+\\
+==== Rezultat ====
+^HTTP kod^Opis|
+|200 OK|Dobija se token u formi //application/json//, npr. ''{"token" : "1712201622047865"}'' |
+|401 Not Authorized|Dobija se tekst greške u //application/json// zapisu|
+|500 Server Error|Bilo koji drugi tip greške u //application/json// zapisu|