1. 刷新token
请求快手服务器,刷新access_token和refresh_token及token过期时间。
请求地址:https://ad.e.kuaishou.com/rest/openapi/oauth2/authorize/refresh_token
请求方式:POST
数据格式:JSON
请求参数:
字段 |
类型 |
备注:快手广告官方网站提供 |
app_id |
number |
申请应用后快手返回的app_id |
secret |
string |
申请应用后快手返回的secret |
refresh_token |
string |
最近一次快手返回的refresh_token |
请求样例:
curl -H "Content-Type:application/json" \ -d ' { "app_id": 1, "secret": "abcd", "refresh_token": "5991a7e2a6c7933b93" } '
|
返回参数:
字段 |
类型 |
描述 |
code |
number |
返回码 |
message |
string |
返回信息 |
data |
JSON |
|
access_token |
string |
用于验证权限的token |
access_token_expires_in |
number |
access_token剩余有效时间,单位:秒 |
refresh_token |
string |
用于获取新的access_token和refresh_token,并且刷新过期时间 |
refresh_token_expires_in |
number |
refresh_token剩余有效时间,单位:秒 |
advertiser_id |
number |
快手广告主ID |
返回样例:
{ "code": 0, "message": "OK", "data": { "access_token":"xxxxxxxxx", "refresh_token_expires_in":xxxxxxxxx, "refresh_token":"xxxxxxxxx", "access_token_expires_in":xxxxxxxxx, "advertiser_id": xxxxxxxxx } } |
2.修改回调地址
请求快手服务器,修改回调地址。注意:请慎重修改,最多可修改5次/月
请求地址:https://ad.e.kuaishou.com/rest/openapi/app/update/redirect_uri
请求方式:POST
数据格式:JSON
请求参数:
字段 |
类型 |
备注 |
app_id |
number |
申请应用后快手返回的app_id |
secret |
string |
申请应用后快手返回的secret |
redirect_uri |
新更新的回调地址 |
返回参数:
字段 |
类型 |
描述 |
code |
number |
返回码 |
message |
string |
返回信息 |
data |
JSON |
3. token有效期&续期
1)access_token
access_token的有效期是1天。当access_token超时后,可以使用refresh_token进行刷新,每次刷新都会产生新的access_token和refresh_token,同时重置二者的有效期,从初始值计起。
2)refresh_token
refresh_token有效期是30天。当refresh_token失效的后,需要通过"获取token",得到全新access_token和refresh_token。刷新后会生成新的token,老的access_token和refresh_token将不可再使用,请每次刷新都做好存储。
4. 返回码
1) 成功返回
code |
msg |
描述 |
0 |
OK |
成功 |
2) 通用返回
code |
msg |
描述 |
400000 |
系统繁忙 |
不可知错误 |
400001 |
请求过于频繁 |
|
400002 |
没有权限进行相关操作 |
没有权限进行相关操作 |
3) 参数相关
code |
msg |
描述 |
401000 |
参数错误 |
部分参数缺失 |
401001 |
参数格式错误 |
参数不符合格式要求 |
401002 |
选取时间跨度过大 |
日期跨度不符合要求 |
401003 |
选取起始时间超过允许范围 |
|
401004 |
选取起始时间晚于结束时间 |
4) auth相关
code |
msg |
描述 |
402000 |
access_token过期 |
|
402001 |
refresh_token过期 |
|
402002 |
auth_code过期 |
|
402003 |
access_token为空 |
|
402004 |
access_token错误 |
|
402005 |
refresh_token错误 |
快手广告全国代理商 |
402006 |
auth_code错误 |
|
402007 |
账户状态异常 |
|
402008 |
授权类型错误 |
|
402009 |
密钥错误 |
|
402010 |
申请权限过大 |
申请的权限大于应用申请时填写的权限 |
402011 |
回调地址错误 |
redirect_uri不是应用申请时填写的回调地址 |
402012 |
应用不存在 |
5) 报表相关错误
code |
msg |
描述 |
410000 |
获取报表数据异常 |
|
410001 |
没有数据权限 |
试图获取非本快手视频广告账户的数据 |
410002 |
优化目标optimize_target错误 |
5. 并发次数
1)单个APP_ID数据查询请求次数限制1,000次/分钟——包括所有授权码;
2)系统整体支持的请求次数限制为10,000次/分钟——包括所有APP_ID。
湖南张家界市快手广告开户流程及费用教程,快手开户优惠政策有哪些呢?广东清远市快手开户怎么做?广东快手开户的价格是5000元么?广西防城港市快手APP开屏广告可以投么?快手开屏广告收费是怎样的?四川达州市快手跟快手直播开户流程是一样的么?陕西榆林市快手开户快不快?陕西快手信息流广告开户需要几天?河北藁城市怎么做快手广告推广?河北快手开屏广告可以投放么?河北遵化市如何做快手推广?河北快手开户需要多长时间?河北南宫市快手广告开户需要提供哪些资质?河北安国市怎么做快手短视频广告推广?

评论列表