Les kontoens samtaleposter

Hent kontoens samtaleposter

Les poster for innkommende eller utgående samtaler for API-kontoen din. Disse postene inneholder private opplysninger om samtaler og fakturering. Behandle dem i autoriserte arbeidsflyter på serversiden, og unngå unødvendig logging eller deling.

Dette eldre endepunktet har for øyeblikket en fast standardperiode og ingen sideinndeling. Bruk portalens arbeidsflyt for samtalehistorikk og eksport når du trenger en annen rapporteringsperiode eller store eksporter av historiske data; parametere for egendefinerte datoer i dette endepunktet er ikke pålitelige.

Forespørsler

Autentiser deg over HTTPS med den aktiverte API-kontoen din fra kontoens tillatte kilde-IP-adresse. Eksemplet bruker påloggingsopplysninger i miljøvariabler. Forespørslene som støttes for standardperioden, trenger ingen forespørselskropp.

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

Stier for forespørsler om samtaleposter
Sti	Omfang
/v3/cdrs	Kontoens poster for innkommende samtaler i standardperioden.
/v3/cdrs/{number}	Poster for innkommende samtaler der nummeret samsvarer nøyaktig med det oppgitte nummeret. Bruk helst hele sifferrekken som er oppført i nummeroversikten din.
/v3/cdrs/all/outbound	Kontoens poster for utgående samtaler i standardperioden. Grenen for utgående samtaler ignorerer det første stiargumentet; all er en plassholder her, ikke et jokertegn for innkommende samtaler.

Bruk retningsangivelsen inbound eller outbound nøyaktig som vist ovenfor. Grenen for utgående samtaler implementerer ikke filtrering per nummer. Hvis du legger til et nummer i denne stien, begrenses ikke resultatene for utgående samtaler.

Standardperiode for rapportering

Spørringen starter ved midnatt på serverens kalenderdato 30 dager før i dag og slutter ved midnatt ved starten av dagen i dag. Den omfatter derfor ikke resten av inneværende dag. Dette er ikke en rullerende periode på 720 timer som slutter på det nåværende tidspunktet.

Den nåværende implementasjonen støtter ikke skjemafeltene date_from/date_to på en pålitelig måte: Når egendefinerte datoer oppgis, blir variablene for partisjonsår stående uten verdi. Ikke bruk disse feltene til en rapport i produksjon. Datoer i spørringsstrengen og parametere for sideinndeling er ikke implementert som alternativer.

Svar

Bare utvalgte felt for innkommende samtaler er vist som illustrasjon; dette er fiktive data og ikke hele den returnerte 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 er en liste. Den felles svarinnpakningen kan inneholde status.results som antall rader. Resultatkoder kan være strenger. Et resultat uten poster bruker API-kode 404 med meldingen No entries found i stedet for et vellykket svar med en tom liste.

Felt i postene

Viktigste returnerte felt
Felt	Betydning
number, callerid	Innkommende nummer og identifikator for den som ringer, i feltutvalget for innkommende samtaler.
calling, called, callerid	Identifikatorer for den som ringer og den som blir oppringt, i feltutvalget for utgående samtaler. Ikke utled en bekreftet abonnentidentitet fra anrops-ID-en.
disposition, billseconds, billcost	Lagret samtalestatus, fakturert varighet og lagret faktureringsbeløp. Verdiene kan bruke eldre strengformater fra databasen.
callsid	Samtalens lagrede UUID for kobling av relaterte opplysninger.
date_created	En dato- og klokkeslettstreng med det bokstavelige suffikset UTC, fremfor et garantert ISO8601-tidsstempel. Angi det returnerte formatet uttrykkelig ved tolking.
Andre felt	Poster for innkommende samtaler inneholder også diagnostikk om feil, kostnad, kanal, kvalitet og opprinnelse; poster for utgående samtaler inneholder diagnostikk om termineringsregion. Det fullstendige svaret kan inneholde opplysninger om infrastruktur og bør behandles som privat informasjon.

Endepunktet legger ikke til eksplisitt sortering eller sideinndeling. Ikke forutsett at de nyeste resultatene kommer først, at radrekkefølgen er stabil, eller at det finnes en markør for inkrementell synkronisering. De returnerte faktureringsfeltene er lagrede samtaleposter, ikke et pristilbud for en fremtidig samtale.

Feil og begrensninger for rapportering

Les både HTTP-statusen og status.code/status.msg i JSON. Hvis det ikke finnes poster for den valgte kontoen og perioden, returneres API-kode 404. Krav til autentisering og begrensninger på kilde-IP gjelder også. En stor rapport uten sideinndeling eller en upålitelig forespørsel med egendefinerte datoer kan mislykkes; gjentatt uthenting av hele tabellen er ikke en strategi for inkrementell eksport.

Den gjennomgåtte behandlingsfunksjonen inneholder lesespørringer og verken belaster kontoen eller starter samtaler. En returnert post beviser ikke at en person svarte; tolk den lagrede samtalestatusen og varigheten ut fra rapporteringsbehovet ditt.