接口简介:
该接口用于TCP推送服务发送消息,详情请登录接口盒子后台查看菜单【TCP服务】。
请求地址:
https://cn.apihz.cn/api/tcp/tcpmsg.php
请求方式:
POST或GET。
请求参数:
【名称】【参数】【必填】【说明】
【用户ID】【id】【是】【用户中心的数字ID,例:id=10000000】
【用户KEY】【key】【是】【用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2】
【消息类型】【msgtype】【是】【消息类型,1=全体推送 2=分类推送 3=指定客户端。例:msgtype=1】
【客户端分类】【type】【否】【当消息类型为2分类推送时必传,自定义客户端分类,在绑定客户端时自定义设置的客户端分类,用于给指定分类的客户端推送消息。例:type=1】
【客户端编号】【bh】【否】【当消息类型为3分类推送时必传,链接服务器后返回的32位客户端编号,用于端对端的单点消息推送,给指定客户端发送一条消息。例:bh=645d2ad6e86f4083e86410025e87314e】
【消息内容】【msg】【是】【消息内容长度根据套餐级别限制,详情请登录后台查看,例:msg=你好吗】
【消息备注】【bz】【否】【给该条消息添加备注,例:bz=测试场景】
返回参数:
【名称】【参数】【说明】
【状态码】【code】【200成功,400错误】
【提示信息】【msg】【信息提示。】
GET请求示例:
https://cn.apihz.cn/api/tcp/tcpmsg.php?id=88888888&key=88888888&msgtype=1&type=&bh=&msg=测试消息&bz=消息备注
注意:示例里的ID与KEY为公共ID与KEY,共享每分钟调用频次限制,接口本身免费,请使用自己的ID与KEY,独享每分钟调用频次。每日调用无上限。
POST请求示例:
请根据开发语言自行POST。
返回数据示例:
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:{"code":200,"msg":"投递推送任务成功"}
参考资料(版权):
https://www.apihz.cn/api/tcptcpmsg.html