Hesabın arama kayıtlarını okuyun

Hesabın arama kayıtlarını alın

API hesabınızın gelen veya giden arama kayıtlarını okuyun. Bu kayıtlar gizli arama ve faturalandırma bilgileri içerir. Bunları yetkili sunucu tarafı iş akışlarında tutun ve gereksiz günlük kaydından veya paylaşımdan kaçının.

Bu eski uç nokta şu anda sabit bir varsayılan tarih aralığı kullanır ve sayfalama sunmaz. Farklı bir raporlama dönemine veya geçmiş verilerin büyük çaplı dışa aktarımına ihtiyaç duyduğunuzda portalın arama geçmişi ve dışa aktarma iş akışını kullanın; bu uç noktadaki özel tarih parametreleri güvenilir değildir.

İstekler

Etkinleştirilmiş API hesabınızı kullanarak, hesabın izin verilen kaynak IP adresinden HTTPS üzerinden kimlik doğrulayın. Örnekte ortam değişkenlerindeki kimlik bilgileri kullanılır. Desteklenen varsayılan tarih aralığı istekleri için istek gövdesi gerekmez.

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

Arama kaydı isteği yolları
Yol	Kapsam
/v3/cdrs	Varsayılan tarih aralığındaki hesaba ait gelen arama kayıtları.
/v3/cdrs/{number}	Numarası belirtilen numarayla tam olarak eşleşen gelen arama kayıtları. Tercihen numara envanterinizde kullanılan rakamların tamamını girin.
/v3/cdrs/all/outbound	Varsayılan tarih aralığındaki hesaba ait giden arama kayıtları. Giden aramaları işleyen dal, ilk yol bağımsız değişkenini yok sayar; all burada bir yer tutucudur, gelen aramalar için bir joker değer değildir.

Yukarıda gösterilen inbound veya outbound yön değerini aynen kullanın. Giden aramaları işleyen dalda numara bazında filtre uygulanmaz. Bu yola bir numara eklemek, giden arama sonuçlarını daraltmaz.

Varsayılan raporlama aralığı

Sorgu, sunucunun takvimine göre bugünden 30 gün önceki günün başlangıcında, gece yarısında başlar ve bugünün başlangıcında, gece yarısında sona erer. Bu nedenle bugünün geri kalanını kapsamaz. Bu, şu anki saatte sona eren hareketli bir 720 saatlik aralık değildir.

Mevcut uygulama, date_from/date_to form alanlarını güvenilir biçimde desteklemez: özel tarihler belirtildiğinde bölümleme yılını belirleyen değişkenler ayarlanmamış kalır. Bu alanları üretim ortamındaki bir rapor için kullanmayın. Alternatif olarak sorgu dizesindeki tarihlerin veya sayfalama parametrelerinin işlenmesi de uygulanmamıştır.

Yanıt

Yalnızca seçilmiş gelen arama alanları örnek olarak gösterilmiştir; bunlar kurgusal verilerdir ve döndürülen kaydın tamamını oluşturmaz.

{
  "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 bir listedir. Ortak yanıt zarfı, satır sayısı olarak status.results alanını içerebilir. Sonuç kodları dize olabilir. Kayıt bulunmadığında başarılı bir boş liste yerine No entries found mesajıyla birlikte 404 API kodu kullanılır.

Kayıt alanları

Döndürülen başlıca alanlar
Alanlar	Anlamı
number, callerid	Gelen aramalar için seçilen alanlardaki gelen arama numarası ve arayan tanımlayıcısı.
calling, called, callerid	Giden aramalar için seçilen alanlardaki arayan ve aranan taraf tanımlayıcıları. Arayan kimliğinden doğrulanmış bir abone kimliği sonucu çıkarmayın.
disposition, billseconds, billcost	Kaydedilmiş arama sonucu, faturalandırılan süre ve kaydedilmiş faturalandırma tutarı. Değerler eski veritabanı dize biçimlerini kullanabilir.
callsid	İlişkilendirme için aramanın kaydedilmiş UUID değeri.
date_created	Sonunda doğrudan UTC metni bulunan bir tarih/saat dizesidir; ISO8601 biçiminde bir zaman damgası olduğu garanti edilmez. Ayrıştırmayı açıkça döndürülen biçime göre yapın.
Diğer alanlar	Gelen arama kayıtları ayrıca hata, maliyet, kanal, kalite ve kaynak tanılama bilgilerini içerir; giden arama kayıtları ise aramanın sonlandırıldığı bölgeye ilişkin tanılama bilgilerini içerir. Tam yanıt, altyapı bilgileri içerebilir ve gizli olarak ele alınmalıdır.

Uç nokta açık bir sıralama veya sayfalama uygulamaz. Sonuçların en yeniden başlayacağını, satır sırasının sabit kalacağını veya artımlı eşitleme imleci bulunacağını varsaymayın. Döndürülen faturalandırma alanları kaydedilmiş arama kayıtlarına aittir; gelecekteki bir arama için fiyat teklifi değildir.

Hatalar ve raporlama sınırları

Hem HTTP durumunu hem de JSON yanıtındaki status.code/status.msg alanlarını okuyun. Seçilen hesapta ve tarih aralığında kayıt yoksa 404 API kodu döndürülür. Kimlik doğrulama ve kaynak IP kısıtlamaları da geçerlidir. Sayfalama içermeyen büyük bir rapor veya güvenilir olmayan bir özel tarih isteği başarısız olabilir; tablonun tamamını tekrar tekrar sorgulamak artımlı bir dışa aktarma stratejisi değildir.

İncelenen işleyici okuma sorguları içerir; hesaptan tutar düşmez veya arama başlatmaz. Döndürülen bir kayıt, aramayı bir kişinin yanıtladığını kanıtlamaz; kaydedilmiş arama sonucunu ve süreyi raporlama amacınıza göre yorumlayın.