小白接口

[多合一] 智能刷新接口

接口链接: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 必须

客户端接入示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

请求:
/?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": ""
}
<?php

// 引入文件
require_once dirname(__FILE__) . '/OkayApiClient.php';

// 请求小白接口
$rs = OkayApiClient::request('App.Main_Counter.SmartRefresh',array('type'=>'day','name'=>'visit_times'));

// 输出结果
print_r($rs);

/*
Array 
( 
	[ret] => 200 
	[data] => Array 
	( 
		[err_code] => 0 
		[err_msg] => 
		[before_value] => 3 
		[after_value] => 4 
	) 
	[msg] => 当前小白接口:App.Main_Counter.SmartRefresh 
)
*/

异常情况

错误码错误类型错误描述信息解决方法
400客户端非法请求非法请求,参数错误1、根据接口文档的接口参数,提供正确的参数
401客户端非法请求用户未登录,或登录凭证已过期1、如果用户未注册,请先用注册接口;2、如果注册未登录或会话过期,请先用登录接口
404客户端非法请求接口服务不存在1、查看小白接口大全,确保接口服务名称拼写正确
406客户端非法请求非法app_key,请核对你所在的接口域名1、在我的套餐查看并核对接口域名
407客户端非法请求当前应用已过期1、进行续费或续约,延长应用有效期
408客户端非法请求当前应用存在异常,已被封号1、联系在线客服人工处理
409客户端非法请求签名错误1、使用在线调试,校正签名;2、关闭特定或全部签名设置;3、如果过期,可以进行续约/升级
410客户端非法请求权限不足,非系统管理员1、应用权限不足,可联系在线客服咨询沟通
411客户端非法请求权限不足,应用管理员未登录1、请提供应用管理员的admin_uuid和admin_token参数后重试
412客户端非法请求权限不足,非应用管理员1、请在小白开放平台把会员设置为管理员
413客户端非法请求本月接口流量超出,已被临时冻结1、开通接口流量叠加包,或升级套餐
414客户端非法请求并发过高1、请降低请求频率,检测是否有死循环调用,或是否被他人恶意使用。如果流量确实很大,可联系在线客服进行定制化或私有云部署。
500小白接口异常如果出现此错误,请联系技术人员处理1、进入QQ交流群660311764,反馈问题;2、或者提交工单,一天内回复

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

如何选择三大数据?

评论(0

暂无评论~

热门接口

安全搜索查询接口
App.Table.FreeQuery
唯一ID生成接口
App.Common_UniqueId.GetUniqueId
创建新数据接口
App.Table.Create
“阅后即焚”接口(专取非重复数据)
App.Table.FreePopOne