Differences

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

--- kb:ws:autorizacija_gettoken [2017/11/27 09:25] – [Parametri] aleksandar
+++ kb:ws:autorizacija_gettoken [2022/12/02 14:18] (current) – [SOAP] milano
@@ Line 8: / Line 8: @@
 ===== Sintaksa =====
-GetToken (companyCode, userName, userCode, sessLen, authCustomer)
+==== 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|
+==== SOAP ====
-|companyCode|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) ======
+^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|
-RESTful metod analogan GetToken() metodi.
+===== Primeri =====
-^HTTP Metod^Primer URLa|
+==== SOAP ====
-|GET|[[http://<server|http://<server]]>/rs/login/gettoken?id=<>&pwd=<>&len=<>&usr=<>&cust=<>|
-===== Parametri =====
+=== Zahtev ===
-^Parametar^Tip^Opis|
+<code>
-|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|
-\\
+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>
-==== Rezultat ====
+</code>
-^HTTP kod^Opis|
+=== Odgovor ===
-|200 OK|Dobija se token u formi //application/json//, npr. ''{"token" : "1712201622047865"}'' |
-|401 Not Authorized|Dobija se tekst greške u //application/json// zapisu|
+<code>
-|500 Server Error|Bilo koji drugi tip greške u //application/json// zapisu|
+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.
+^Karakter^Kod|
+|+|%2B|
+|&|%26|
+|=|%3D|
+=== Odgovor ===
+^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|
+\\