Differences

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

--- kb:api_validate [2024/11/13 13:24] – created ognjen.bogicevic
+++ kb:api_validate [2024/11/20 10:07] (current) – ognjen.bogicevic
@@ Line 1: / Line 1: @@
 ====== Validacija tokena ======
-Ova funkcionalnost omogućava korisnicima da provere da li je njihov trenutni token i dalje važeći i da li im omogućava pristup određenim resursima ili funkcionalnostima.
+Ova funkcionalnost omogućava korisnicima da provere da li je njihov trenutni token i dalje važeći i da li im omogućava pristup određenim resursima ili funkcionalnostima.\\
-Kada se izvrši zahtev "validate", API će proveriti ispravnost pristiglog tokena i vratiti odgovor koji ukazuje da li je token validan ili ne.
+Kada se izvrši zahtev "validate", API će proveriti ispravnost pristiglog tokena i vratiti odgovor koji ukazuje da li je token validan ili ne.\\
 Ovo je korisna funkcionalnost koja pomaže u održavanju sigurnosti API-ja i sprečavanju neovlašćenog pristupa resursima.
@@ Line 11: / Line 11: @@
 <code>
 POST https://ws.melany.rs/api/rest/auth/validate
 </code>
@@ Line 17: / Line 18: @@
 <code>
 POST https://ws.melany.rs/api/soap/auth/validate
 </code>
 ==== Ulazni parametri ====
-^Naziv^Tip^Obavezno^Opis^Revizija|
+Da bi se API zahtev uspešno izvršio, potrebno je u zaglavlje zahteva ubaciti aktivan token kao ulazni parametar. Token se ubacuje pod ključem “Authorization: Bearer ” u skladu sa standardima za autentifikaciju.
-|username|String|Obavezno polje|Korisničko ime koje se koristi za autentifikaciju.|24-11-13|
-|password|String|Obavezno polje|Korisnička lozinka dodeljena korisniku prilikom otvaranja naloga.|24-11-13|
-|duration|Integer|Nije obavezno polje|Trajanje autentifikacijskog tokena se izražava u minutama. Ako nije specificirano ili je vrednost postavljena na 0, podrazumevano vreme trajanja tokena je 24 časa.|24-11-13|
-|company|Integer|Obavezno polje|Identifikator kompanije ili entiteta koji zahteva autentifikaciju.|24-11-13|
 ===== Rezultat =====
-^Naziv^Tip^Opis|
+U slučaju provere validnosti tokena, API vraća rezultat u zavisnosti od statusa tokena:
-|code|String|Niz karaktera, određenog roka trajanja, koji jedinstveno identifikuju korisnika i sesiju u kojoj radi.|
-|expires|Date|Datum i vreme istak tokena prema postavljenom parametru "duration".|
+  *
+  * Ako je token validan, rezultat će biti "True".
+  * Ako token nije validan, rezultat će biti "False".
+Ovaj mehanizam omogućava jednostavnu proveru stanja tokena pre izvršavanja daljih akcija.
 ===== Primeri =====
 === REST Zahtev ===
 <code>
+curl -X 'GET' \
-curl -X 'POST' \
+  'https://ws.melany.rs/api/rest/auth/validate' \
-  'https://ws.melany.rs/api/rest/auth' \
+  -H 'accept: */*' \
-  -H 'accept: application/json' \
+  -H 'Authorization: Bearer eyJjdHkiOiJKV1QiLCJhbGciOiJSU0EtT0FFUCIsImVuYyI6IkEyNTZHQ00ifQ.lUels6Qmt3_djpFGZda_H8ci9lZxQAMHmPozWk4t6APkENvC5YIuW9ZSs5oW3fBOY7oADefCouMkybNvSkzh1WH-wlYzQLs_qknB5ethuXsONxhF18H7iOiBMw1GDgaqzh5b_gKbfrd3Lxv53GjP8U-k60DTok-KicduZz5aJRQ0a2nhrg90Ou0gGkkKfA2YGL5-ATamGJmXfA5bTvrkw_D6TS9BPoF9y9uvMOkuonvylQ34CUXSSNLEXpk2bkcNp8iXrZ76y6WGEu834GaPu3Cf9hU6gmP2iHh27V8qDpl2GHm-UPBq6Sy1fyBoru5rvxka3UV1yOguawz6gWEO5g.vwKH9K7Jbec2Ic4f.M-ZsfERMcdvcLLFoBRAzYV3xaFBym8Ob22lNqBYB0LTCiHK43gdApia3dENT8vf30nkz353GSoAvk7c4IHM6NZsZ_SH5hqNb4G10WvuxB4y6xIrLb_3tZDQ-hRWJZd5GodK1H_kabD_80Lf9zhAY0y-ajzYxS_U7Jz9Hm3nOigftZH20gTdVFgWNSv2YJVyah1BhO6iWtV9kg2P4NxCkUKPLls-M9jLG7uqSdP5oSUblTZqPqjg-1oFJUELFCfOngFCZg4zlkEKD2CTH5zQ5V6-bMs5evypBKrMQjlI_Vf32jPrTOl8hV2BWVGEnj-ECxwmpmvUxOdAANqUKSK6-FUHZjWf4R2THSKznKkYQHywSyohEGjO03Xbovpbhwykk6YyT-8n6Itvosyo9877aOKZckVgZfpB4PRhAjwyDLzAYPKmQnCwZ9sJxCAcSwqT8i55MzX-1blOkMySEOOTah7UuZa7iWwY1N4rXWx_Q9O7jPb4arpVoHRMuI5eLodOCER_HVFWv3BnBj6UIgJA4A67k1HJw0_x11I8PNW7-GeysA1SIMj7M95xdA-GUhctg7rY2besuguKgP0pERfH3iO__DRsTZz4NE7E27D6KddgHGVA0kk2bAKFE8TzhT9_ISoCEKusHyE6JC2lPLzqhFvQWX8K2kiT__Os18tZ0-jop0Vd0BMipsMBtwAIP1Aoi2diPuyBER4OWGb8kEcwnHwjYoZddHVy-LMfQ7E50dwYdEkHBgioZJfLR76aCJpStKY6veMLM1j9r7BWRuV4vYaDV6-elW4fQPhNSy0TsAqqTAcdqFiAqyAOx752bXBOooEMcfP0_ESCKyyRCCz8R4hplpV1m-3NAqIg7VkLC4aHC1yiyxzw22HYELwStr6IHm6gnWycSkKq7oFldE2keGt0yKPAMMGTffKnSfmQnODarQ9laF6QrYsCf_-f3FaUYaMKtZxR24vrsVDZ06TjqUVA8bcV4WrCmnF5PrgAamqGHYypZO83MqDojwA3w48aBTcBaZ9zEX4-gAnkOgWUQ8-WHMIXFhOGV-SxXJcvwvWDW_SjZWbrIjPgfigbSqQ0VfT7oM3VfvaviIKtCnfJ8UDg5kACqEnoxB2v77o6Po5NKI80zSTEpgMkXsGA4EDWn1en729cUFwyiDQsIx2lPq9vFWc74jpOST9loWrGm9Dvidse4igWLDzxIZhGd6MA90QDDHpciw07s0wf2WCjd4VjChuritOX_o70PD5eZsjjFNJAXn0xHyAQjN78Vr6axPmBIivZswLbcbEKtKfknQiAeNYbyM6kxyeV1Ll2wOj3gVw3WTosV7A.iYLmSMWVZPhHNsOFWd85vA' \
-  -H 'Content-Type: application/json' \
+  -H 'Content-Type: application/text' \
-  -d '{
+  -d ''
-  "username": "melany",
-  "password": "password",
-  "duration": 0,
-  "company": 10
-}'
 </code>
@@ Line 54: / Line 52: @@
 <code>
-{
-  "code": "eyJjdHkiOiJKV1QiLCJhbGciOiJSU0EtT0FFUCIsImVuYyI6IkEyNTZHQ00ifQ.gI21vCXCCrQms35AWsEj_C5xYDhn_23Sdmbd-J1mx4tQkAqAsLG2JgwQSKaMHcNfHA0pKSFJ5q_9uf-zhRRX0KzCvo6-ZLrqpb6UccIRSGIrCXtFUtRKGPX2g6ruqhj2S7IMoGavisGP7C4xaYkD3KjM5obXvWaEgphBlvotGk8D2z9GbtgVNKGpTyX5JLvceUo4FGFWHtHlXwEYtLAFi8BP_gD0BkCspXEra9CdGx7JS-hwKDzbDmtVH1NoOAMdMpk0SySjay_TNrj-qCx7UuHkusqumgA2aoWWz-W_HEy6KJnRw-nQjBYsz3hm380QI4-leusaaCt-hXAQc7gWpQ.cfFmJD-9FdeM7uS8.BegAuobF5oQuNyDAsWIFUx_kW7Tb4fyGjXAbyTNRQHIRuufZqNJAGBubkqw0zmY9M5Opmk8INy057U0PbtSOWfv9s5PC2cIGyqLpNa4L8X3o_E-ID_W0R1acX5f9QFv1iQA9YXUG9OBZ1stn6fP7wjO-YpAWZEQFkj45Mnjwp2P1cB63BO3GX8l26qKkP7dvcH_-y8aJ6DtBle0zVm0HZmtipaU5rfN0-U13ffEG9RXe0pUWyBngwRe6ZLEca2pe9NUNllFUtiUnuoe_P4qZ2797Ocvrlx7r8wzAzfvzMNYzFWLXweKjN4Zfp5eeH7DVVBJoeSLuNfUeCDI3K5T0k2BTZDCpBYHJfulx-aaSmhwcXd4omqhgO6uikYk_5mzamSDIepElcNfz-PNgMZ9a5p0z_AoltF63MjVqd_PJHLJOtRrbdJDnVBUJ2d0_O4PzpO15rh7e0vt9ob-yNUA3GGKbCv0gngzDKALSX7RLWRmkSxQom6pAQq2r1m6YUnSoaMymVSt_4couIFJhcDUiLZzPHeIAZluYdmODVT_P7UAqDF3fpP6XCgKwOnnMh24Wg0LbAdFK6HhMO8M2jTLcNl43yeq5iuOkrzBEa5lsDQFwVIQF6uMevht6VAVH8o6vlJuHew3B3GfpuvgczoqD6-7hPfYfL01FMA8yKuH4oARpeE5h7nr9b80NQ7sOF9w9qamh12mDf-jNOQqeVImHALcJzqRYEMCwt3sfI-JUi6yNrlGaXnOmju_Mec9t7NT-euIbFcQ8ENfEG5CfB3gHYZmhbwFXqWICaYFKxtzZSQPyUJKIcXlh1tCHU4eLS-nHjNJGLyTa7o9sON8xlNH-ZIzgxj29Uz4bjLW7taaT20BCG4K31JF7QUu4pDBvFxhnSsECrY1aVdiIHYTegNWO5f9YtbDKm78jakKcEbjrqSQE2T9W-hm6-S9SFSoHonhUk9xSXyPu8H7K4F-eMGDGyOerpMewjm_PZW-aFdWue6Uo_Sa9aXXwchc7B-hkalVNVfK-S288ltzzjVqTqVJLHsQPfzG_gBv9YoYtQRlJWi_n-ZGkfRld0N-G1JKeZxTZabN0XZGzNWGO2T49M3lreJ6XLQoz0O-zv3foUImBWng7oFuhwtWbMZi_aQgr7hmdsCF8YM0tsXfXIUuN1F_ivOhmmQe43tzAsIVXxouYmoT4ANKcDCO5qA2Ucz0d1aH0wO48SueKa14BAzE88YZcBcN2Q1I6hrwT9CL7Y23GEJ1zNYhduNFg_C7qDqiB1yQ0R6Cn3zaNU3Sm1EEzdyPQEcrB1y1Ab4Pf5GS30JVD9M4ysg8-xUqnCamjn75K849gaw6u.kbnbsleJG4VJoSyPnZzOOQ",
+True
-  "expires": "2024-11-14 12:53:24"
-}
 </code>