Използвайте HTTPS и HTTP Basic удостоверяване с одобрени API идентификационни данни. Съхранявайте идентификационните данни на сървъра на приложението си. Тези крайни точки на хостван PBX използват /hpbx/ на api.multitel.net; не вмъквайте /v3. Проверявайте както HTTP резултата, така и статуса на резултата от операцията на ниво приложение в JSON отговора.
Заявете данни за ограничен период от дати
curl --request POST --user "USERNAME:PASSWORD" \
--data-urlencode "date_from=2026-10-01" \
--data-urlencode "date_to=2026-10-02" \
--data-urlencode "disposition=ANSWERED" \
"https://api.multitel.net/hpbx/cdrs/YOUR_BILLING_CODE?start=0&length=50"Заменете кода за фактуриране и датите. Филтрите за дати включват посочените дни. За тази крайна точка филтрите в тялото са кодирани като формуляр, а странирането е в низа на заявката.
Филтри и отговор
| Параметър | Значение |
|---|---|
| date_from / date_to | Начална/крайна дата във формат YYYY-MM-DD. |
| wherelanded | Филтър по дестинация при необходимост. |
| disposition | Филтър по резултат от обаждането, например ANSWERED. |
| callerid | Филтър по номера на обаждащия се. |
| timezone | Поддържаният идентификатор на часова зона, когато се използва; не приемайте, че приема име от IANA. |
| start / length | Параметри на заявката, които управляват върнатата страница. |
Записите за разговорите съдържат начален час, идентичност на обаждащия се, източник, първа дестинация, таксуеми секунди, състояние и идентификатори на разговора. Използвайте върнатата структура на резултата за тази крайна точка; тя може да се различава от странирането в API на портала. Успешна HTTP заявка не е доказателство, че резултатът съдържа съответстващи разговори.
За REST интеграциите с портала използвайте актуалната справочна документация за историята на повикванията, включително схемата на отговора и разрешенията за акаунта.