小白接口

[多合一] 智能刷新

接口链接:http://api.okayapi.com/?s=App.Main_Counter.SmartRefresh

功能说明: 当计数器时,执行更新操作;当计数器不存在时,执行创建并初始化,初始的默认值为0,最小值为0,最大值为9,999,999,999,可见性为public。相当于Setup和Update接口的组合,简化客户端使用

容易程度:

分类标签:免费  热门  验签

请求协议
HTTP/HTTPS
请求方式
GET/POST
编码格式
UTF-8
返回格式
JSON

在线调试    添加收藏    直接访问接口    评论(0    loading...

接口参数

参数名字类型是否必须默认值其他说明
sign字符串可选签名,如果不需要签名,可在小白后台进行签名设置
app_key字符串必须最小:32;最大:32应用ID。查看我的app_key
uuid字符串可选最小:32;最大:32UUID,全局唯一用户ID
token字符串可选最小:64;最大:64会话凭证
type枚举类型必须范围:hour/day/week/month/year/forever计数器类型,时/日/周/月/年/永久计数器
name字符串必须最小:1;最大:64计数器名称
value整型必须1待增量更新的值,为正数时增加,为负数则减少

返回结果

返回字段类型说明
err_code整型状态操作码,0成功,1计数器不存在
err_msg字符串错误提示信息,err_code非0时参考此提示信息
before_value整型更新前原来的值
after_value整型更新后的值

简易在线调试

参数是否必填
service 必须
uuid 可选
token 可选
type 必须
name 必须
value 必须

调用示例

请求:
/?s=App.Main_Counter.SmartRefresh&type=day&name=visit_times&value=1&app_key={你的app_key}&sign={动态签名}

返回:
{
    "ret": 200,
    "data": {
        "err_code": 0,
        "err_msg": "",
        "before_value": 6,
        "after_value": 7
    },
    "msg": ""
}

异常情况

错误码错误描述信息解决方法
400非法请求,参数错误1、根据接口文档的接口参数,提供正确的参数
401用户未登录,或登录凭证已过期1、如果用户未注册,请先用注册接口;2、如果注册未登录或会话过期,请先用登录接口
404接口服务不存在1、查看小白接口大全,确保接口服务名称拼写正确
406权限不足,应用签名错误、或者应用已过期1、使用在线调试,校正签名;2、关闭特定或全部签名设置;3、如果过期,可以进行续约/升级
500小白接口内部系统错误,如果出现此错误,请联系技术人员处理1、进入QQ交流群660311764,反馈问题;2、或者提交工单,一天内回复

如何使用应用的三大数据?

如何选择三大数据?

评论(0

暂无评论~
// 获取评论