云端状态查询接口
此接口几乎在所有场景下都用不到。
此接口只作为云端状态的辅助查询,严禁使用此接口做云端状态的轮询,否则将自动导致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,可在系统后台设置页面查看 |