SparkTG

CDR-Bericht (v2)-Dokumentation

CDR-Bericht (v2)

v2

CDR-Bericht (v2)

Anrufdetaildatensätze für einen Zeitraum

API v2v21 Endpunkt

Übersicht

Abrechnungspflichtig: Diese API wird nach der Anzahl der zurückgegebenen Datensätze abgerechnet. Wenden Sie sich für Preisdetails an Ihren Account Manager. Gibt Anrufdetaildatensätze für den Service und den Zeitraum zurück. Senden Sie einen JSON-Body (Content-Type: application/json). start_time und end_time sind Pflichtfelder, wie bei jedem Reports-Endpunkt; eine Anfrage ohne diese Felder liefert 400. svc_id ist optional und entspricht standardmäßig dem Service des Tokens; wenn Sie es senden, muss der Benutzer des Tokens für diesen Service autorisiert sein, andernfalls liefert die Anfrage 403. Das Feld mode wählt normal (Standard, eine normale CDR-Liste mit Summen) oder extended (dieselben Datensätze plus IVR- und Warteschlangen-Zeiten sowie Wartezeiten). Der Request-Body ist in beiden Modi identisch. limit ist auf 5000 begrenzt; bei höheren Werten wird auf 5000 reduziert. Verwenden Sie daher offset, um größere Ergebnismengen seitenweise abzurufen. Unbekannte Parameter werden ignoriert.

Verfügbare Endpunkte

POST/api/v2/reports/cdr

Wichtige Parameter

mode(String)

normal (Standard) oder extended.

svc_id(Integer)

Service, für den der Bericht erstellt wird. Standardmäßig der Service des Tokens.

start_time(Integer (epoch ms))

Beginn des Zeitfensters.

end_time(Integer (epoch ms))

Ende des Zeitfensters (exklusiv bezogen auf die Startzeit des Anrufs).

offset(Integer)

Pagination-Offset (in beiden Modi gleich). Standard 0.

limit(Integer)

Seitengröße. Standard 30. Maximum 5000; größere Werte werden begrenzt.

Nutzungsszenarien

Normaler Modus

Der Standard. ring_start_time, start_time und end_time werden als Strings im Format yyyy-MM-ddTHH:mm:ss in IST zurückgegeben.

0 ParameterIn den Beispielen verfügbar

Erweiterter Modus

mode auf extended setzen. Die Hülle und alle Felder des normalen Modus bleiben unverändert; jeder Datensatz enthält zusätzlich agent_answered, ivr_in_time, ivr_out_time, ivr_duration, queue_in_time, queue_out_time, queue_duration und total_wait_duration.

0 ParameterIn den Beispielen verfügbar

Kurzbeispiel

Testen Sie diese API mit einem einfachen cURL-Befehl

Einfacher API-Aufruf
curl -X POST 'https://telephonycloud.co.in/api/v2/reports/cdr' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"svc_id": 3, "start_time": 1775759400000, "end_time": 1776364200000, "offset": 0, "limit": 30, "call_type": "OUTBOUND", "disposition": "ANSWER"}'
💡 Ersetzen Sie <YOUR_TOKEN> durch Ihr API-Token

Antwortvorschau

Beispielantwort dieser API

Beispielantwort
{"count":268,"data":[{"call_transaction_id":"d341e47a-767a-44fb-8d79-9bf38f4caa28","svc_id":3,"call_type":"OUTBOUND","customer_number":"9634780846","agent_number":"10101","disposition":"Answer","durat...
Vollständiges Antwortformat im Abschnitt „Antwort“ ansehen