API prístup: ako skracovať odkazy priamo z vlastnej aplikácie

Kedy sa oplatí API namiesto webu

Webové rozhranie je ideálne na vytvorenie pár odkazov denne. Ak ale potrebujete skracovať odkazy automaticky — napríklad pri každej novej objednávke v e-shope, pri publikovaní článku, alebo hromadne pre stovky produktov naraz — ručné kopírovanie cez formulár sa rýchlo stane nepraktickým. Presne na to slúži API.

Ako získať prístupový token

Prihláste sa a v dashboarde otvorte sekciu API tokeny.
Vygenerujte nový token jedným kliknutím.
Token sa zobrazí len raz — uložte si ho bezpečne (napríklad do premennej prostredia, nikdy priamo do kódu uloženého vo verejnom repozitári).

Príklad volania API

Skrátenie odkazu prebieha jednoduchým POST requestom:

curl -X POST https://odkz.sk/api/v1/shorten \
  -H "Authorization: Bearer VAS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://vasweb.sk/produkt/12345", "custom_code": "produkt-12345"}'

Odpoveď obsahuje skrátenú URL aj ďalšie metadáta o vytvorenom odkaze. Rovnakým spôsobom môžete poslať aj utm_source, utm_medium, expires_at alebo max_clicks — presne tie isté možnosti, aké ponúka aj webový formulár.

Limity

API je chránené rozumným rate limitom (60 požiadaviek za minútu na token), aby zostalo stabilné pre všetkých používateľov. Počet odkazov, ktoré cez API vytvoríte, sa počíta do rovnakého limitu ako odkazy vytvorené cez web — Free plán 5 odkazov, PRO plán 30.

Typické use-case scenáre

E-shop automaticky generuje skrátený a sledovateľný odkaz ku každej novej objednávke alebo produktovej stránke
Redakčný systém pri publikovaní článku rovno vytvorí krátky odkaz na zdieľanie na sociálnych sieťach
Interný nástroj hromadne skráti zoznam stoviek URL naraz namiesto ručného vkladania jednej po druhej

Prečo API namiesto vlastného riešenia

Postaviť si vlastný systém na skracovanie odkazov znamená riešiť generovanie unikátnych kódov, ochranu pred zneužitím, ukladanie štatistík aj kontrolu škodlivých URL od nuly. Pripojením na hotové API odkz.sk získate všetko vrátane Safe Browsing kontroly a analytiky bez toho, aby ste túto infraštruktúru museli stavať a udržiavať sami.