Odorik.cz API

Pro přístup ke službám Odorik.cz z aplikací třetích stran poskytujeme API na adrese https://www.odorik.cz/api/v1/. Parametry jsou předávány standardně pomocí URI-encoding (respektive form-encoding na základě použité HTTP metody). Na většinu požadavků se snažíme odpovídat HTTP stavovým kódem 200 OK.

Většina operací vyžaduje autentizaci uživatele. Ta se provádí zasláním přihlašovacích údajů společně s požadavkem. Jedná se o proměnné user a password, přičemž existují dvě možnosti pro přihlášení:

• Přihlášení platné pro celý účet
  • user - ID registrovaného uživatele služby Odorik.cz
  • password - speciální heslo určené pro API volání daného uživatele najdete jej po přihlášení v menu Nastavení účtu→API heslo
  • Hodnoty obou proměnných můžete pro svůj účet nalézt na https://www.odorik.cz/ucet/nastaveni_uctu.html?ucet_podmenu=api_heslo
• Přihlášení platné pro konkrétní linku
  • user - číslo linky v síti Odorik.cz
  • password - heslo pro danou linku (používané například i pro SIP autentizaci)
  • Seznam vašich linek můžete nalézt na http://www.odorik.cz/ucet/linky.html, hesla poté po kliknutí na jednotlivé linky.

Operace vyžadující autentizaci mohou vracet následující odpovědi:

• error authentication_required
• error authentication_failed

Při použití API k implementaci některé z funkcí Odorik.cz do aplikací třetích stran (jako například Esmska nebo DreamCom) používejte prosím u požadavků nepovinný parametr user_agent.

• Hovory
  • callback
  • historie volání
  • nahrané hovory
  • právě probíhající hovory
• Kredit
  • přeposlaní jinému uživateli
  • současný stav
• Linky
• Rychlé kontakty
• SIM karty
• SMS
• Veřejná čísla
  • paralelní zvonění
  • routování
• Text-to-speech

Několik ukázek kódu je k dispozici na stránce Ukázky použití Odorik API.

Rozcestník aplikací používající naše API naleznete na stránce Aplikace využivající Odorik API.

Potřebuje-li vaše aplikace informaci u novém příchozím hovoru, web hook můžete nastavit podle návodu zde. vzdalene_rizeni_pres_web

Pokud byste rádi přistupovali k některé ze služeb Odorik.cz pomocí API, kontaktujte nás prosím na karasODDELEJTOHLE@odorik.cz.