推送退订黑名单

使用该接口需提前在客户服务群告知使用账号,我司需对账号开通此服务。

推送地址: 用户自定义,登陆3tong.net配置,位置如图:

请求方式:

编码统一为UTF-8,采用post方式提交请求。数据格式为JSON。收到Http请求后,使用getParameter(“black”)获取相应内容。
推送请求头,Content-Type:application/x-www-form-urlencoded

功能:
实时推送用户回复r,td,t,n,qx,0000,bzjs导致退订我司短信以及用户回复dy,jc取消退订我司短信的用户号码。

请求示例

其中black参数对应的完整值如下:
{"account": "dh123","blacks": [{"action": "unsubscribe","phone": "13711111111","sign": "【大汉三通】","time": "20121231165900"}, {"action": "subscribe","phone": "13822222222","time": "20121231165900"}]}

black参数结构说明

参数名 类型 必填 说明
account String 用户账号
blacks JsonArray 多条退订信息,最多200条

blacks包结构参数说明:

参数名 类型 必填 说明
action String 固定值:unsubscribe(退订)、subscribe(取消退订)
phone String 手机号码
sign String 签名,针对某个签名退订、取消退订
time String 时间(发送时间格式为:yyyyMMddHHmmss,例如2012年12月31日16时59分0秒,即为20121231165900)
remark String 备注,退订、取消退订时的说明信息

响应数据格式:

{
    "status":"success"
}

返回参数说明:

参数名 说明
status 处理结果,成功时status的值返回success,其他值均认为推送失败。
文档更新时间: 2023-12-21 17:18   作者:夏亮