Dokumentácia pre skužby poskytujúce autentifikáciu potrebnú na prístup na API Informačného systému PLIS

Na autentifkáciu slúži služba https://auth.plis.sk, ktorá na základe prístupových údajov vygeneruje token, ktorý sa následne využíva na prístup na API https://api.plis.sk

Organizácie

Pre prístup organizácie je potrebné jej IČO a UUID pridelené systémom PLIS. Na základe týchto údajov sa generuje token.

cURL:

$ curl 'https://auth.plis.sk/plis/org' -i -X POST -H 'Accept: text/plain' -H 'Content-Type: application/json; charset=UTF-8' -d '{"username":"12345678","password":null,"key":"f180c6b9-44fd-42cf-8eaa-7f84e3f2c0dc"}'

HTTP request:

POST /plis/org HTTP/1.1
Accept: text/plain
Content-Type: application/json; charset=UTF-8
Host: auth.plis.sk
Content-Length: 84

{"username":"12345678","password":null,"key":"f180c6b9-44fd-42cf-8eaa-7f84e3f2c0dc"}

HTTPie:

$ echo '{"username":"12345678","password":null,"key":"f180c6b9-44fd-42cf-8eaa-7f84e3f2c0dc"}' | http POST 'https://auth.plis.sk/plis/org' 'Accept:text/plain' 'Content-Type:application/json; charset=UTF-8'

HTTP response:

HTTP/1.1 200 OK
Content-Type: text/plain;charset=UTF-8
Content-Length: 224
Date: Mon, 12 Jun 2017 06:45:53 GMT

byJhbGbiOiJIUzUxMiJ9.byJqbGkiOiIyIiwib3ViIjoiMzY3ODMxMTEiLCJyb2xlbyI6WyJST0xFX1BMSVNfQkMiXSwibWNvIjoiMzY3ODMxMTEiLCJlbHAiOjE0OTbzMzYzNTN9.SAWPQ1Qv2LShioE0f1f42-XTsYUt7lNopWCvJNhX76qsOmKh-Ox3UUH1OX8bCwiYhi7XLpr187CpYIAm4bUAEA

Používatelia PLIS

Pre prístup používateľa IS PLIS je potrebné jeho meno a heslo pridelené systémom PLIS. Na základe týchto údajov sa generuje token.

cURL:

$ curl 'https://auth.plis.sk/plis/user' -i -X POST -H 'Accept: text/plain' -H 'Content-Type: application/json; charset=UTF-8' -d '{"username":"username","password":"password","key":null}'

HTTP request:

POST /plis/user HTTP/1.1
Accept: text/plain
Content-Type: application/json; charset=UTF-8
Host: auth.plis.sk
Content-Length: 56

{"username":"username","password":"password","key":null}

HTTPie:

$ echo '{"username":"username","password":"password","key":null}' | http POST 'https://auth.plis.sk/plis/user' 'Accept:text/plain' 'Content-Type:application/json; charset=UTF-8'

HTTP response:

HTTP/1.1 200 OK
Content-Type: text/plain;charset=UTF-8
Content-Length: 182
Date: Mon, 12 Jun 2017 06:45:53 GMT

byJhbGbiOiJIUzUxMiJ9.byJzbWIiOiJhbGlwbGlzIiwibm9sZXMiOlsiUExJU19BUEkiXSwiZXhwIjoxNDk3MzM2MzUzfQ.wZfGfyts-HSL8WvFpoIwLbWHNmybbiHYpvvvjQbYK6H-GF2HQV8J1wvu6EMBTZKbt1mwHPGHZgbL0g0I5i2tDw