API klíč je identifikační údaj, kterým se vaše aplikace přihlašuje k API Quandy. Vytvoříte ho v Quandě v Nastavení / API klíče tlačítkem Přidat API klíč a posíláte ho v hlavičce každého požadavku. Popis všech volání najdete v API dokumentaci verze 1.

Jak vytvořit API klíč

  1. V Quandě klikněte na tři tečky / Nastavení / API klíče.
  2. Klikněte na zelené tlačítko Přidat API klíč.
  3. Do pole Popis API klíče napište název, podle kterého klíč poznáte, například Raynet CRM nebo e-shop.
  4. Klikněte na Uložit. Klíč se objeví v seznamu, odkud ho zkopírujete.
Stránka API klíče v Quandě se seznamem klíčů, sloupci Vytvořeno, API klíč a Popis API klíče a zeleným tlačítkem Přidat API klíč.
API klíče v Quandě.

Ve sloupci Akce klíč změníte nebo smažete. API klíč chraňte jako heslo a pro každou aplikaci si vytvořte vlastní.

Jak API klíč použít v požadavku

Klíč posíláte v hlavičce authorization ve tvaru Token a za mezerou váš klíč. Základní adresa API je https://api.onquanda.com/api/. Spojení si ověříte voláním ping:

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

Přes API se Quanda chová, jako by byl přihlášený administrátor vašeho účtu. Přístup je omezený právy a tarifem účtu.

Jaká omezení API má

  • Na jeden API klíč posílejte požadavky postupně, ne souběžně.
  • Mezi koncem jednoho a začátkem dalšího požadavku je prodleva 30 ms.
  • Při příliš častém přístupu vrátí API kód 429 Too many requests a požadavek je potřeba zopakovat.
  • Některá volání jsou omezená množstvím vstupních dat.

Kde najdete API dokumentaci

Aktuální API dokumentace, verze 1 popisuje kontakty, štítky, hromadný import, e-mailové kampaně, transakční e-maily, příjemce, dotazníky, uživatele a webhooky. Hotová propojení bez programování, třeba s Raynet CRM, najdete v článku Propojení Quandy s webem, CRM nebo jiným softwarem.

Pokud si nevíte rady nebo máte dotaz, neváhejte kontaktovat naši zákaznickou podporu na support@onquanda.com nebo na telefonu +420 605 163 892.

Časté otázky

Klikněte na tři tečky, Nastavení, API klíče a na zelené tlačítko Přidat API klíč. Klíč pojmenujte, například podle aplikace, která ho bude používat, a uložte.

Klíč posíláte v hlavičce authorization ve tvaru Token a za mezerou váš klíč, spolu s hlavičkou content-type application/json. Základní adresa API je https://api.onquanda.com/api/.

Přes API se Quanda chová, jako by byl přihlášený administrátor účtu. Přístup je omezený právy a tarifem vašeho účtu.

Na jeden API klíč posílejte požadavky postupně, ne souběžně. Mezi koncem jednoho a začátkem dalšího požadavku je prodleva 30 ms. Při příliš častém přístupu vrátí API kód 429 Too many requests a požadavek je potřeba zopakovat.

Ano. Pro každou aplikaci si můžete vytvořit vlastní klíč a pojmenovat ho. V seznamu API klíčů klíč změníte nebo smažete, když ho aplikace už nepotřebuje.