文档

SecretRingReport

您可以通过HTTP批量推送方式订阅中间状态响铃事件消息(SecretRingReport),获取呼叫过程中的响铃信息。

注意事项

仅部分运营商平台号码支持订阅SecretRingReport。

协议说明

参数

说明

协议

HTTP + JSON

编码

UTF-8

请求说明

请求内容为JSON Array格式,单次请求可能会包含多个通话记录。

请求样例

[{
        "phone_no": "1314456****", 
        "secret_no": "1304984****", 
        "peer_no": "1304984****", 
        "call_type": "1", 
        "call_id": "4461122c480****", 
        "call_time": "2021-12-10 10:00:00", 
        "pool_key": "FC2256****", 
        "ring_time": "2021-12-10 10:00:03", 
        "sub_id": "100004306803****", 
        "city": "西安", 
        "out_id": "8136812621****"
}]

字段说明

参数名

参数类型

示例

描述

phone_no

String

1314456****

AXB中的A号码。

secret_no

String

1304984****

隐私号码。

peer_no

String

1380000****

AXB中的B号码或者N号码。

call_type

Number

1

呼叫类型。取值:

  • 0:主叫,即phone_no打给peer_no

  • 1:被叫即peer_no打给phone_no

  • 4:呼叫拦截。

call_id

String

44611dd0c30****

呼叫记录ID。

call_time

String

2021-12-10 10:00:00

主叫拨打时间。

pool_key

String

FC2256****

号码池Key。

ring_time

String

2021-12-10 10:00:03

振铃时间。

sub_id

Long

100004306803****

绑定关系ID。

city

String

西安

隐私号码归属地。

out_id

String

8136812621****

外部业务ID。

extension

String

8011

分机号。

响应说明

响应样例

{
  "code" : 0,
  "msg" : "接收成功"
}

字段说明

名称

类型

是否必选

示例值

描述

code

Number

0

应答编码。

msg

String

接收成功

描述信息。

说明
  • 系统仅校验返回值的code是否为数字,不校验内容。若HTTP状态码为200,请求成功。HTTP状态码非200或响应超时情况下,系统会进行重试推送。

  • 若出现系统异常、消费失败等情况,建议HTTP响应码返回50X。

重新推送

第一次推送失败后,间隔1分钟、5分钟、10分钟后会进行重推,直至推送成功为止。如果推送3次后仍失败,不再重试。

  • 本页导读 (1)
文档反馈