5.6.2 api phone calllog

Funkce /api/phone/calllog umožňuje stahovat nebo mazat všechny nebo vybrané záznamy hovorů.

Funkce je součástí služby Phone/Call a v případě použití autentizace je nutné, aby uživatel měl přiřazené privilegium Telefon/hovory – sledování. 

Přehled záznamů zobrazuje informace:

  • Typ volání
    • Příchozí volání (spojené nebo odmítnuté)
    • Zmeškané volání (příchozí nevyzvednuté)
    • Vyzvednuto jinde (příchozí vyzvednuté na jiném zařízení)
    • Odchozí volání (bez ohledu na výsledek)
    • Zvonkové tlačítko
  • Typ kontaktu (nastavení ikony kontaktu)
  • ID volaného/volajícího
  • Datum a čas volání


Metoda GET nebo POST

Funkce nemá žádné parametry.

Odpověď je ve formátu application/json a obsahuje aktuální stav zařízení:

ParametrPopis
idJednoznačná identifikace záznamu.
callType

Specifikuje typ volání.

  • incoming
  • outgoing
  • missed
  • voicemail
  • completedElsewhere
  • zvonkové tlačítko
devTypeInterní identifikátor zařízení.
nameSpecifikuje jméno uživatele z telefonního seznamu.
dateDatum záznamu volání.
durationDefinuje dobu volání v sekundách.

Záznamy jsou seřazené od nejnovějšího k nejstaršímu podle absolutního času vytvořeného záznamu.

Upozornění

  • Pole je prázdné v případě, že nejsou k dispozici žádné záznamy.

Příklad:

{
  "success" : true,
  "result" : {
    "callLog" : [
      {
        "id" : ID,
        "callType" : "incoming",
        "devType" : "2-14-0-0",
        "name" : "Franta Vomáčka",
        "date" : "2027-11-06T12:23:52Z",
        "duration": 1514
      },
      {
        "id" : ID,
        "callType" : "incoming",
        "devType" : "4-13-1-2",
        "name" : "Pepa Vonášek",
        "date" : "2027-12-06T12:23:52Z",
        "duration": 15
      },
      ...
    ]
  }
}
Zvonkové tlačítko
{
  "success" : true,
  "result" : {
    "callLog" : [
      {
        "id" : ID,
        "callType" : "doorbell",
        "date" : "2027-11-06T12:23:52Z"
      },
      ...
    ]
  }
}

Metoda DELETE

Funkce je součástí služby Phone/Call API a v případě použití autentizace je nutné, aby uživatel měl přiřazené privilegium Phone/Call Access Control

Parametry požadavku:

Parametr

Popis

id

Jednoznačná identifikace záznamu, který bude smazán.

Příklad:

{
  "success" : false,
  "error" : {
    "code" : 12,
    "param" : "id",
    "description" : "record not found"
  }
}