您可以通過HTTP批量推送方式訂閱呼叫發起時話單報告消息(SecretStartReport),可以在呼叫發起時立即獲取到通話記錄信息,包括通話開始時間、主被叫號碼等,便于平臺進行預判處理。
協議說明
參數 | 說明 |
協議 | HTTP + JSON |
編碼 | UTF-8 |
請求說明
請求內容為JSON Array格式,單次請求可能會包含多個通話記錄。
請求樣例
[{
"phone_no": "138****0000",
"pool_key": "12345678",
"city": "重慶",
"sub_id": 100002390038****,
"out_id": "123456",
"unconnected_cause": 0,
"call_time": "2021-08-10 15:35:36",
"peer_no": "138****0000",
"called_display_no": "158****0000",
"call_id": "4461122c480****",
"partner_key": "FC1390000****",
"id": "101407590****",
"secret_no": "138****0000",
"call_type": 0,
"control_type": "CONTINUE"
}]
字段說明
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
phone_no | String | 是 | 138****0000 | A號碼。 |
pool_key | String | 是 | FC10000012345**** | 對應的號池Key。 |
city | String | 否 | 重慶 | X號碼歸屬地。 |
out_id | String | 否 | 123456 | 外部業務ID。 |
sub_id | Long | 否 | 100002390038**** | 綁定關系ID。 |
unconnected_cause | Number | 否 | 0 | 未接通通話的原因。 取值:
|
call_time | String | 否 | 2021-08-10 15:35:36 | 主叫撥打時間。 |
peer_no | String | 是 | 138****0000 | B號碼、N號碼或者G組號碼。 |
called_display_no | String | 是 | 158****0000 | 被叫顯號。 |
call_id | String | 否 | 4461122c480**** | 通話ID。 說明 call_id長度限制在100個字符以內。 |
partner_key | String | 是 | FC1390000**** | 商戶Key。 |
id | String | 是 | 101407590**** | 主鍵。 |
secret_no | String | 是 | 138****0000 | 隱私號碼。 |
call_type | Number | 否 | 1 | 呼叫類型。取值:
|
control_type | String | 否 | CONTINUE | 當前接續階段。取值:
|
control_msg | String | 否 | NO_SUBS_EXIST | 無綁定關系時返回NO_SUBS_EXIST。 |
響應說明
響應樣例:
{
"code" : 0,
"msg" : "接收成功"
}
字段說明:
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
code | Number | 是 | 0 | 應答編碼。 |
msg | String | 否 | 接收成功 | 描述信息。 |
系統僅校驗返回值的code是否為數字,不校驗內容。若HTTP狀態碼為200,請求成功。HTTP狀態碼非200或響應超時情況下,系統會進行重試推送。
若出現系統異常、消費失敗等情況,建議HTTP響應碼返回50X。
重新推送
第一次推送失敗后,間隔1分鐘、5分鐘、10分鐘后會進行重推,直至推送成功為止。如果推送3次后仍失敗,不再重試。