Käytä HTTPS:ää ja HTTP Basic -todennusta hyväksytyillä API-tunnuksilla. Säilytä tunnukset sovelluspalvelimellasi. Nämä Hosted PBX -päätepisteet käyttävät kohdetta /hpbx/ kohteessa api.multitel.net; älä lisää kohdetta /v3. Tarkista sekä HTTP-tulos että toiminnon tila JSON-vastauksessa.
Pyydä tiedot rajatulta aikaväliltä
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"Vaihda laskutuskoodi ja päivämäärät. Päivämääräsuodattimet sisältävät mainitut päivät. Tässä päätepisteessä rungon suodattimet ovat lomakekoodattuja ja sivutus on kyselymerkkijonossa.
Suodattimet ja vastaus
| Parametri | Merkitys |
|---|---|
| date_from / date_to | Alkamis- ja päättymispäivät muodossa YYYY-MM-DD. |
| wherelanded | Kohdesuodatin tarvittaessa. |
| disposition | Puhelun tuloksen suodatin, esimerkiksi ANSWERED. |
| callerid | Soittavan numeron suodatin. |
| timezone | Tuettu aikavyöhykkeen tunniste, kun sitä käytetään; älä oleta sen hyväksyvän IANA-nimeä. |
| start / length | Kyselyparametrit, jotka ohjaavat palautettavaa sivua. |
Puhelutiedot sisältävät aloitusajan, soittajan tunnisteen, lähteen, ensimmäisen kohteen, laskutettavat sekunnit, lopputuloksen ja puhelutunnisteet. Käytä tämän päätepisteen palauttamaa tulosrakennetta; se voi erota portaalin API-sivutuksesta. Onnistunut HTTP-pyyntö ei todista, että tulos sisältää vastaavia puheluita.
Käytä portaalin REST API -integraatioissa ajantasaista puheluhistorian viitedokumentaatiota, mukaan lukien vastausrakenne ja tilin käyttöoikeudet.