Zoznam krokov ku komunikácii s API za použitia tokena:
- Vygenerovať klienta.
- Získať token.
- Zadať token do hlavičky požiadavky.
Podrobnejšie informácie o tokenoch nájdete na stránke s popisom spôsobov autentizácie.
1. Vygenerovanie klienta
Pre získanie tokena je potrebné vygenerovať klienta. Nového klienta vytvoríte v agende API kliknutím na tlačidlo Nový klient v sekcii Prístup pomocou prístupového tokena.
Tým sa vygenerujú údaje ClientId a Client secret, ktoré sa zobrazia v dialógovom okne. Jedná sa o tajné údaje (najmä Client secret), ktoré je potrebné uložiť na bezpečnom mieste mimo aplikácie mPOHODA.
2. Získanie tokena
Zaslaním požiadavky, ktorá obsahuje Client Id a Client Secret na token endpoint, dôjde k prideleniu access tokena, ktorý sa následne použije v hlavičke požiadavky.
Adresa endpointu je https://ucet.pohoda.cz/connect/token.
Požiadavka pre získanie tokena
POST https://ucet.pohoda.cz/connect/token| Názov | Typ | Popis |
|---|---|---|
Content-Type |
string | Hodnota application/x-www-form-urlencoded |
| Názov | Typ | Popis |
|---|---|---|
grant_type |
string | reťazec client_credentials |
client_id |
string | hodnota Client Id z administrácie v agende API |
client_secret |
string | hodnota Client Secret z administrácie v agende API |
scope |
string | reťazec Mph.OpenApi.Access.Sk |
upozornění Token má obmedzenú platnosť. Po vypršaní platnosti nie je možné token obnoviť a je potrebné získať nový. Viac informácii nájdete na stránce s popisom spôsobov autentizácie.
3. Odoslanie požiadavky na API
Všetky požiadavky smerujú na URL začínajúce na https://api.mpohoda.sk/v1.
Token je potrebné vložiť do hlavičky požiadavky Authorization: Bearer <access token>, napr. Authorization: Bearer SU1pU...
curl -X GET https://api.mpohoda.sk/v1/issuedinvoices -H "accept: application/json" -H "Authorization: Bearer SU1pUaERCbWMxcXVrRSJ9..."