SparkTG

ログイン / ログアウト Raw レポート (v2)ドキュメント

ログイン / ログアウト Raw レポート (v2)

v2

ログイン / ログアウト Raw レポート (v2)

ログインと休憩のタイムライン。ステータス区間ごとに 1 行

API v2v21件のエンドポイント

概要

課金対象: この API は返されたレコード数に応じて課金されます。料金の詳細はアカウントマネージャーにお問い合わせください。ログインと休憩の生のタイムラインをフラットなレポートとして返し、ステータス区間ごとに 1 行 (サービス ID、エージェント、SIP、時刻、継続時間、ステータス) になります。SIP/内線を持たないエージェントは除外されます。期間は 1 日以内でなければならず、超える場合は 400 を返します。レスポンスの start_time と end_time は IST の yyyy-MM-ddTHH:mm:ss 形式の文字列で、duration の単位は秒です。

利用可能なエンドポイント

POST/api/v2/reports/loginout-raw

主なパラメーター

svc_id(Integer)

レポート対象のサービス。デフォルトはトークンのサービス。

start_time(Integer (epoch ms))

期間の開始。

end_time(Integer (epoch ms))

期間の終了。範囲は 1 日以内でなければならず、超える場合は 400。

agent_sip(String)

エージェントの SIP/内線で絞り込み。カンマ区切りのリストも可。省略するか空にすると全エージェントが対象です。

簡単なサンプル

簡単なcURLコマンドでこのAPIを試す

基本的なAPI呼び出し
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": ""}'
💡 <YOUR_TOKEN> をお使いの API トークンに置き換えてください

レスポンスのプレビュー

このAPIのサンプルレスポンス

サンプルレスポンス
[{"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"}]
レスポンス全体の形式はレスポンスセクションをご覧ください