Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revisionBoth sides next revision | ||
kb:ws:autorizacija_gettoken [2017/11/20 09:48] – aleksandar | kb:ws:autorizacija_gettoken [2019/12/24 13:19] – [Sintaksa] 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, | ||
+ | |||
+ | |||
+ | ===== 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// | ||
+ | |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://< | ||
+ | |||
+ | ===== 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 // | ||
+ | |401 Not Authorized|Dobija se tekst greške u // | ||
+ | |500 Server Error|Bilo koji drugi tip greške u // | ||
+ | |||
+ | \\ | ||