Hämta kontots samtalsposter
Läs inkommande eller utgående samtalsposter för ditt API-konto. Posterna innehåller privata samtals- och faktureringsuppgifter. Hantera dem i behöriga arbetsflöden på serversidan och undvik onödig loggning eller delning.
Den här äldre ändpunkten har för närvarande en fast standardperiod och saknar sidindelning. Använd portalens arbetsflöde för samtalshistorik och export när du behöver en annan rapporteringsperiod eller stora exporter av historiska uppgifter; egna datumparametrar är inte tillförlitliga i den här ändpunkten.
Förfrågningar
Autentisera via HTTPS med ditt aktiverade API-konto från dess tillåtna käll-IP-adress. Exemplet använder inloggningsuppgifter i miljövariabler. Ingen meddelandekropp behövs för de förfrågningar med standardperiod som stöds.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| Sökväg | Omfattning |
|---|---|
| /v3/cdrs | Kontots inkommande samtalsposter inom standardperioden. |
| /v3/cdrs/{number} | Inkommande samtalsposter vars nummer exakt matchar det angivna numret. Använd helst hela sifferföljden som finns i ditt nummerbestånd. |
| /v3/cdrs/all/outbound | Kontots utgående samtalsposter inom standardperioden. Kodgrenen för utgående samtal ignorerar det första sökvägsargumentet; all är här en platshållare, inte ett jokertecken för inkommande samtal. |
Använd exakt den riktning, inbound eller outbound, som visas ovan. Kodgrenen för utgående samtal saknar filtrering per nummer. Att lägga till ett nummer i den sökvägen begränsar inte resultaten för utgående samtal.
Standardperiod för rapportering
Frågeperioden börjar vid midnatt på det kalenderdatum enligt servern som inföll 30 dagar före dagens datum och slutar vid midnatt när dagens datum börjar. Därför ingår inte resten av innevarande dag. Det är inte en rullande period på 720 timmar som slutar vid den aktuella tidpunkten.
Den nuvarande implementationen ger inte tillförlitligt stöd för formulärfälten date_from/date_to: om egna datum anges förblir dess variabler för partitionsår odefinierade. Använd inte dessa fält för en rapport i produktion. Datum i frågesträngen och parametrar för sidindelning har inte implementerats som alternativ.
Svar
Endast utvalda fält för inkommande samtal visas som illustration; uppgifterna är fiktiva och utgör inte hela den returnerade posten.
{
"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 är en lista. Det gemensamma svarshöljet kan innehålla status.results som anger antalet rader. Resultatkoder kan vara strängar. Om inga poster finns används API-koden 404 med meddelandet No entries found i stället för en tom lista som anger ett lyckat resultat.
Posternas fält
| Fält | Betydelse |
|---|---|
| number, callerid | Inkommande nummer och uppringaridentifierare i fälturvalet för inkommande samtal. |
| calling, called, callerid | Identifierare för uppringande och uppringd part i fälturvalet för utgående samtal. Dra inte slutsatsen att uppringaridentifieringen styrker abonnentens identitet. |
| disposition, billseconds, billcost | Lagrat samtalsutfall, fakturerad varaktighet och lagrat faktureringsbelopp. Värdena kan använda äldre strängformat från databasen. |
| callsid | Samtalets lagrade UUID för att koppla samman uppgifter. |
| date_created | En datum- och tidssträng med det bokstavliga suffixet UTC, inte en garanterad tidsstämpel enligt ISO8601. Tolka uttryckligen det format som returneras. |
| Övriga fält | Poster för inkommande samtal innehåller även diagnostik om fel, kostnad, kanal, kvalitet och ursprung; poster för utgående samtal innehåller diagnostik om termineringsregion. Det fullständiga svaret kan innehålla uppgifter om infrastrukturen och ska behandlas som privat information. |
Ändpunkten lägger inte till någon uttrycklig sortering eller sidindelning. Utgå inte från att de senaste resultaten kommer först, att radordningen är stabil eller att det finns en markör för inkrementell synkronisering. De returnerade faktureringsfälten är lagrade samtalsuppgifter, inte en prisuppgift för ett framtida samtal.
Fel och rapporteringsbegränsningar
Läs både HTTP-statusen och status.code/status.msg i JSON-svaret. Om det inte finns några poster för det valda kontot och den valda perioden returneras API-koden 404. Krav på autentisering och begränsningar för käll-IP-adress gäller också. En stor rapport utan sidindelning eller en otillförlitlig förfrågan med egna datum kan misslyckas; upprepade avfrågningar av hela tabellen är inte en strategi för inkrementell export.
Den granskade hanteraren innehåller läsfrågor och varken debiterar kontot eller initierar samtal. En returnerad post bevisar inte att en person svarade; tolka det lagrade samtalsutfallet och varaktigheten utifrån ditt rapporteringsbehov.