Čtení záznamů hovorů účtu

Načtení záznamů hovorů účtu

Čtěte záznamy příchozích nebo odchozích hovorů svého účtu API. Tyto záznamy obsahují soukromé informace o hovorech a účtování. Zpracovávejte je pouze v autorizovaných postupech na straně serveru a vyhněte se zbytečnému protokolování nebo sdílení.

Tento starší koncový bod má v současnosti pevně dané výchozí období a nepodporuje stránkování. Pokud potřebujete jiné období výkazu nebo rozsáhlé exporty historických dat, použijte v portálu postup pro historii hovorů a export; parametry vlastních dat v tomto koncovém bodě nejsou spolehlivé.

Požadavky

Ověřte se přes HTTPS pomocí svého aktivovaného účtu API z jeho povolené zdrojové IP adresy. Příklad používá přihlašovací údaje v proměnných prostředí. Podporované požadavky za výchozí období nepotřebují tělo požadavku.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/cdrs

Cesty požadavků na záznamy hovorů
Cesta	Rozsah
/v3/cdrs	Záznamy příchozích hovorů účtu za výchozí období.
/v3/cdrs/{number}	Záznamy příchozích hovorů, jejichž číslo přesně odpovídá zadanému číslu. Používejte přednostně úplnou posloupnost číslic uvedenou ve vaší evidenci čísel.
/v3/cdrs/all/outbound	Záznamy odchozích hovorů účtu za výchozí období. Větev pro odchozí hovory ignoruje první argument cesty; all zde slouží jako zástupná hodnota, nikoli jako zástupný znak pro příchozí hovory.

Použijte přesně označení směru inbound nebo outbound uvedené výše. Větev pro odchozí hovory neimplementuje filtr podle jednotlivých čísel. Přidání čísla do této cesty neomezí výsledky odchozích hovorů.

Výchozí období výkazu

Dotaz začíná o půlnoci kalendářního dne serveru 30 dní před dneškem a končí o půlnoci na začátku dnešního dne. Nezahrnuje tedy zbytek aktuálního dne. Nejde o průběžně posouvané období v délce 720 hodin končící v aktuálním okamžiku.

Současná implementace spolehlivě nepodporuje formulářová pole date_from/date_to: při zadání vlastních dat zůstanou její proměnné pro rok databázového oddílu nenastavené. Nepoužívejte tato pole pro výkazy v produkčním provozu. Data v řetězci dotazu ani parametry stránkování nejsou implementovány jako alternativy.

Odpověď

Pouze vybraná pole příchozích hovorů pro ilustraci; jde o smyšlená data, nikoli o úplný vrácený záznam.

{
  "status": {
    "code": "200",
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "callerid": "12025550124",
      "disposition": "ANSWERED",
      "billseconds": "60",
      "billcost": "0.0100",
      "callsid": "11111111111111111111111111111111",
      "date_created": "2026-10-01 12:00:00 UTC"
    }
  ]
}

response je seznam. Společná obálka odpovědi může obsahovat status.results jako počet řádků. Kódy výsledků mohou být řetězce. Pokud nejsou nalezeny žádné záznamy, výsledek používá kód API 404 se zprávou No entries found namísto úspěšné odpovědi s prázdným seznamem.

Pole záznamu

Hlavní vracená pole
Pole	Význam
number, callerid	Číslo příchozího hovoru a identifikátor volajícího ve výběru polí příchozích hovorů.
calling, called, callerid	Identifikátory volajícího a volaného ve výběru polí odchozích hovorů. Z identifikace volajícího nevyvozujte ověřenou totožnost účastníka.
disposition, billseconds, billcost	Uložený stav hovoru, účtovaná délka a uložená účtovaná částka. Hodnoty mohou používat starší databázové formáty řetězců.
callsid	Uložený identifikátor UUID hovoru pro propojování souvisejících záznamů.
date_created	Řetězec data a času s doslovnou příponou UTC; nejde o zaručené časové razítko ve formátu ISO8601. Při zpracování výslovně určete vrácený formát.
Další pole	Záznamy příchozích hovorů obsahují také diagnostické údaje o selhání, nákladech, kanálu, kvalitě a původu; záznamy odchozích hovorů obsahují diagnostické údaje o oblasti ukončení hovoru. Úplná odpověď může obsahovat informace o infrastruktuře a je třeba s ní zacházet jako se soukromými údaji.

Koncový bod nepřidává žádné výslovné řazení ani stránkování. Nepředpokládejte řazení výsledků od nejnovějších, stabilní pořadí řádků ani kurzor pro přírůstkovou synchronizaci. Vrácená pole účtování představují uložené záznamy hovorů, nikoli cenovou nabídku na budoucí hovor.

Chyby a omezení výkazů

Čtěte stav HTTP i pole status.code/status.msg v JSON. Pokud pro vybraný účet a období neexistují žádné záznamy, vrátí se kód API 404. Platí také požadavky na autentizaci a omezení zdrojové IP adresy. Rozsáhlý výkaz bez stránkování nebo nespolehlivý požadavek s vlastními daty může selhat; opakované dotazování na celou tabulku není strategií přírůstkového exportu.

Zkontrolovaná obslužná funkce obsahuje dotazy pro čtení a neprovádí odečtení prostředků z účtu ani zahájení hovoru. Vrácený záznam nedokazuje, že hovor přijal člověk; uložený stav a délku hovoru vyhodnocujte podle účelu svého výkazu.