SparkTG

Login-/Logout-Rohbericht (v2)-Dokumentation

Login-/Logout-Rohbericht (v2)

v2

Login-/Logout-Rohbericht (v2)

Login- und Pausen-Zeitleiste, eine Zeile pro Statussegment

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. Die rohe Login- und Pausen-Zeitleiste als flacher Bericht, mit einer Zeile pro Statussegment (Service-ID, Agent, SIP, Zeit, Dauer, Status). Agents ohne SIP/Durchwahl werden ausgelassen. Das Zeitfenster darf höchstens einen Tag betragen, andernfalls liefert die Anfrage 400. start_time und end_time in der Antwort sind Strings im Format yyyy-MM-ddTHH:mm:ss in IST; duration ist in Sekunden angegeben.

Verfügbare Endpunkte

POST/api/v2/reports/loginout-raw

Wichtige Parameter

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. Der Bereich darf höchstens 1 Tag betragen, andernfalls 400.

agent_sip(String)

Nach Agent-SIP/Durchwahl filtern, oder eine kommagetrennte Liste. Weglassen oder leer lassen für alle Agents.

Kurzbeispiel

Testen Sie diese API mit einem einfachen cURL-Befehl

Einfacher API-Aufruf
curl -X POST 'https://telephonycloud.co.in/api/v2/reports/loginout-raw' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"svc_id": 3, "start_time": 1776277800000, "end_time": 1776364200000, "agent_sip": ""}'
💡 Ersetzen Sie <YOUR_TOKEN> durch Ihr API-Token

Antwortvorschau

Beispielantwort dieser API

Beispielantwort
[{"service_id":3,"agent_name":"Ravi Kumar","sip":"1042","start_time":"2026-04-16T00:00:00","end_time":"2026-04-16T01:00:00","duration":3600,"status_code":1,"status_label":"Meal"}]
Vollständiges Antwortformat im Abschnitt „Antwort“ ansehen