Извличане на записите за обаждания на акаунта
Прочетете записите за входящи или изходящи обаждания за своя API акаунт. Тези записи съдържат поверителна информация за обажданията и таксуването. Обработвайте ги в упълномощени работни процеси на сървъра и избягвайте ненужно записване в журнали или споделяне.
Тази наследена крайна точка понастоящем има фиксиран период по подразбиране и няма страниране. Използвайте работния процес за история на обажданията и експортиране в портала, когато ви е необходим друг отчетен период или голям експорт на исторически данни; параметрите за произволни дати в тази крайна точка не са надеждни.
Заявки
Удостоверете се през HTTPS със своя активиран API акаунт от разрешения за него изходен IP адрес. Примерът използва идентификационни данни в променливи на средата. За поддържаните заявки за периода по подразбиране не е необходимо тяло на заявката.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| Път | Обхват |
|---|---|
| /v3/cdrs | Записи за входящи обаждания на акаунта за периода по подразбиране. |
| /v3/cdrs/{number} | Записи за входящи обаждания, чийто номер съвпада точно с подадения номер. За предпочитане подавайте пълната поредица от цифри, използвана във вашия регистър на номерата. |
| /v3/cdrs/all/outbound | Записи за изходящи обаждания на акаунта за периода по подразбиране. Клонът за изходящи обаждания игнорира първия аргумент в пътя; тук all е запълваща стойност, а не заместващ шаблон за входящи обаждания. |
Използвайте посоката inbound или outbound точно както е показана по-горе. Клонът за изходящи обаждания не реализира филтър по номер. Добавянето на номер към този път не ограничава резултатите за изходящи обаждания.
Отчетен период по подразбиране
Периодът на заявката започва в полунощ на календарната дата на сървъра, която е 30 дни преди днешната дата, и завършва в полунощ в началото на днешния ден. Следователно той не включва останалата част от текущия ден. Това не е плъзгащ се период от 720 часа, който завършва в текущия момент.
Текущата реализация не поддържа надеждно полетата на формуляр date_from/date_to: при подаване на произволни дати променливите за годините на дяловете остават незададени. Не използвайте тези полета за отчет в продукционна среда. Дати в низа на заявката и параметри за страниране не са реализирани като алтернативи.
Отговор
Показани са само избрани полета за входящи обаждания с илюстративна цел; данните са измислени и не представляват целия върнат запис.
{
"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 е списък. Общата обвивка на отговора може да включва status.results като брой редове. Кодовете на резултатите могат да бъдат низове. Когато няма записи, резултатът използва код API 404 със съобщение No entries found вместо успешен отговор с празен списък.
Полета на записите
| Полета | Значение |
|---|---|
| number, callerid | Номерът, към който е насочено входящото обаждане, и идентификаторът на обаждащия се в набора от полета за входящи обаждания. |
| calling, called, callerid | Идентификатори на повикващата и повикваната страна в набора от полета за изходящи обаждания. Не приемайте, че самоличността на абоната е потвърдена въз основа на идентификацията на обаждащия се. |
| disposition, billseconds, billcost | Съхраненият резултат от обаждането, таксуваната продължителност и съхранената сума за таксуване. Стойностите може да използват наследени формати на низове от базата данни. |
| callsid | Съхраненият UUID на обаждането за съпоставяне на свързани записи. |
| date_created | Низ с дата и час с буквалния суфикс UTC, без гаранция, че е времеви печат във формат ISO8601. При разчитане задавайте изрично върнатия формат. |
| Други полета | Записите за входящи обаждания включват също диагностични данни за неуспехи, разходи, канал, качество и произход; записите за изходящи обаждания включват диагностични данни за региона на терминиране на обаждането. Пълният отговор може да съдържа информация за инфраструктурата и трябва да се третира като поверителен. |
Крайната точка не задава изрично подреждане или страниране. Не приемайте, че най-новите резултати са първи, че редът на записите е постоянен или че има курсор за инкрементална синхронизация. Върнатите полета за таксуване представляват съхранени записи за обаждания, а не ценова оферта за бъдещо обаждане.
Грешки и ограничения при отчитане
Проверявайте както статуса HTTP, така и status.code/status.msg в отговора JSON. При липса на записи за избрания акаунт и период се връща код API 404. Прилагат се и ограниченията за удостоверяване и изходен IP адрес. Голям отчет без страниране или ненадеждна заявка с произволни дати може да завърши с неуспех; многократното запитване на цялата таблица не е стратегия за инкрементално експортиране.
Прегледаният обработчик съдържа заявки за четене и не дебитира акаунта, нито инициира обаждания. Върнатият запис не доказва, че човек е отговорил; тълкувайте съхранения резултат и продължителност на обаждането според нуждите на вашия отчет.