Differences

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

--- kb:ws:autorizacija_gettoken [2019/12/24 13:19] – [Sintaksa] aleksandar
+++ kb:ws:autorizacija_gettoken [2022/12/02 14:18] (current) – [SOAP] milano
@@ Line 7: / Line 7: @@
 **Poziv metode sadrži osetljive podatke, korisničku lozinku, pa je preporuka da se za transportni protokol koristi ****https (TSL).**
 ===== Sintaksa =====
+==== SOAP ====
 GetToken (companyCode, userName, userCode, sessLen, [authUser], [authCustomer])
+==== REST ====
+<code>
+POST https://(server_base_url)/rs/login/gettoken?id=&pwd=&len=&usr=&cust=
+</code>
 ===== Rezultat =====
 **String** sessToken; Niz karaktera, određenog roka trajanja, koji jedinstveno identifikuju korisnika i sesiju u kojoj radi.
 ===== Parametri =====
-^Naziv^Vrsta^Opis^Revizija|
+==== SOAP ====
-|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|
-\\
+^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 =====
-====== gettoken (RESTful) ======
+==== SOAP ====
-RESTful metod analogan GetToken() metodi.
+=== Zahtev ===
-^HTTP Metod^Primer URLa^Revizija|
+<code>
-|GET|[[http://<server|http://<server]]>/rs/login/gettoken?id=<>&pwd=<>&len=<>&usr=<>&cust=<>|19-6-11|
-===== Parametri =====
+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>
+</code>
+=== Odgovor ===
+<code>
+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>
+</code>
+==== REST ====
+=== Zahtev ===
+<code>https://ws.melany.rs:8191/BortApp-war/rs/login/gettoken?id=balans_username&pwd=balans_password&len=30</code>
+Napomena: Ukoliko //username// ili //password// sadrže komandne karaktere URL-a (''&'',''+'',''='') neophodno ih je zameniti ANSI kodom.
-^Parametar^Tip^Opis^Revizija|
+^Karakter^Kod|
-|id|String|Korisnički nalog provajdera (obavezan) =userName|19-6-11|
+|+|%2B|
-|pwd|String|Šifra provajderskog naloga (obavezan) =userCode|19-6-11|
+|&|%26|
-|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|
+|=|%3D|
-|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 ====
+=== Odgovor ===
 ^HTTP kod^Opis^Revizija|