云端状态查询接口


此接口几乎在所有场景下都用不到。

此接口只作为云端状态的辅助查询,严禁使用此接口做云端状态的轮询,否则将自动导致IP进入黑名单!

正确的业务逻辑:请在系统后台设置offline_notify_url,云端会向此地址发起掉线提醒


请求地址(不支持浏览器直接打开):https://open.yunmianqian.com/api/cloud

调用方法:POST (注意请求头中的 content-type 必须为 application/x-www-form-urlencoded )

请求参数:

字段名称 字段类型 是否必填 说明
app_id int(16) Y 应用ID,在后台系统设置页面查看
sign string(32) Y 签名,将参数按 app_id + app_secret 顺序拼接后md5(32位小写)(纯 value 拼接,不要包含 + 号)。注意最后一个参数是app_secret,可在云端系统后台设置页面查看

接口返回:

字段名称 字段类型 是否必填 说明
code int(16) Y 200:成功调用,1001:签名错误,1003:缺少参数
msg string(32) Y 状态信息,code字段所对应的信息。200:"success",1001:"secret_incorrect",1003:"missing_argument" 。不支持本地调试
data string(32) Y 将下面的所有参数括起来
wechat_status string(32) Y 云端微信监控状态。返回值为online/offline,分别为在线/离线
alipay_status string(32) Y 云端支付宝监控状态。返回值为online/offline,分别为在线/离线
mipay_status string(32) Y 米支付监控状态。返回值为online/offline,分别为在线/离线

接口返回示例:

 {
     "code":200,
     "msg":"success",
     "data":{
          "wechat_status": "online",
          "alipay_status": "online",
          "mipay_status": "online",
     }
 }

当云端监控掉线后,云端会向你的注册邮箱发送掉线通知,同时立即向你的服务器offline_notify_url地址(若有)发起通知提醒,可自行开发业务逻辑,比如短信提醒、serverChan微信提醒。只要返回"success"小写单词字符串(不包括引号),那么云端会认为通知成功。

接口地址:你在后台设置的offline_notify_url 参数

调用方法:POST

调用参数:

字段名称 字段类型 是否必填 说明
app_id int(16) Y 应用ID。在后台系统设置页面查看
cloud_name string(32) Y 云端监控平台名称。返回值为wechat/alipay/mipay
offline_at string(32) Y 掉线时间
server_time string(32) Y 服务器时间
sign string(32) Y 签名, 将参数 app_id + cloud_name + offline_at + server_time + app_secret 顺序拼接后md5(32位小写)(纯 value 拼接,不包含 + 号)。注意最后一个参数是app_secret,可在系统后台设置页面查看

results matching ""

    No results matching ""