API kľúč je identifikačný údaj, ktorým sa vaša aplikácia prihlasuje k API Quandy. Vytvoríte ho v Quande v Nastaveniach / API kľúče tlačidlom Pridať API kľúč a posielate ho v hlavičke každej požiadavky. Aktuálna API dokumentácia je vo verzii 1.

Ako vytvoriť API kľúč

  1. V Quande kliknite na tri bodky / Nastavenia / API kľúče.
  2. Kliknite na zelené tlačidlo Pridať API kľúč.
  3. Do poľa Popis API kľúče napíšte názov, podľa ktorého kľúč spoznáte, napríklad Raynet CRM alebo e-shop.
  4. Kliknite na Uložiť. Kľúč sa objaví v zozname, odkiaľ ho skopírujete.
Stránka API kľúče v Quande so zoznamom kľúčov, stĺpcami Vytvorený, API kľúč a Popis API kľúče a zeleným tlačidlom Pridať API kľúč.
API kľúče v Quande.

V stĺpci Akcia kľúč zmeníte alebo zmažete. API kľúč chráňte ako heslo a pre každú aplikáciu si vytvorte vlastný.

Ako API kľúč použiť v požiadavke

Kľúč posielate v hlavičke authorization v tvare Token a za medzerou váš kľúč. Základná adresa API je https://api.onquanda.com/api/. Spojenie si overíte volaním ping:

GET https://api.onquanda.com/api/helper/ping/
content-type: application/json
authorization: Token VAS_API_KLUC

Cez API sa Quanda správa, akoby bol prihlásený administrátor vášho účtu. Prístup je obmedzený právami a tarifou účtu.

Aké obmedzenia API má

  • Na jeden API kľúč posielajte požiadavky postupne, nie súbežne.
  • Medzi koncom jednej a začiatkom ďalšej požiadavky je prestávka 30 ms.
  • Pri príliš častom prístupe vráti API kód 429 Too many requests a požiadavku treba zopakovať.
  • Niektoré volania sú obmedzené množstvom vstupných dát.

Kde nájdete API dokumentáciu

API dokumentácia v angličtine je na stránke Dokumentácia API, odkaz nájdete aj v pätičke webu. Vo verzii 1 opisuje kontakty, štítky, hromadný import, e-mailové kampane, transakčné e-maily, príjemcov, dotazníky, používateľov a webhooky. Aké hotové prepojenia bez programovania existujú, napríklad s Raynet CRM, nájdete v článku Prepojenie Quandy s webom, CRM alebo iným softvérom.

Ak si neviete rady alebo máte otázku, neváhajte kontaktovať našu zákaznícku podporu na support@onquanda.com alebo na telefóne +420 605 163 892.

Časté otázky

Kliknite na tri bodky, Nastavenia, API kľúče a na zelené tlačidlo Pridať API kľúč. Kľúč pomenujte, napríklad podľa aplikácie, ktorá ho bude používať, a uložte.

Kľúč posielate v hlavičke authorization v tvare Token a za medzerou váš kľúč, spolu s hlavičkou content-type application/json. Základná adresa API je https://api.onquanda.com/api/.

Cez API sa Quanda správa, akoby bol prihlásený administrátor účtu. Prístup je obmedzený právami a tarifou vášho účtu.

Na jeden API kľúč posielajte požiadavky postupne, nie súbežne. Medzi koncom jednej a začiatkom ďalšej požiadavky je prestávka 30 ms. Pri príliš častom prístupe vráti API kód 429 Too many requests a požiadavku treba zopakovať.

Áno. Pre každú aplikáciu si môžete vytvoriť vlastný kľúč a pomenovať ho. V zozname API kľúčov kľúč zmeníte alebo zmažete, keď ho aplikácia už nepotrebuje.