王尘宇王尘宇

研究百度干SEO做推广变成一个被互联网搞的人

快手信息流广告平台API对接:账户授权模块《NO.2》


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开屏广告可以投么?快手开屏广告收费是怎样的?四川达州市快手跟快手直播开户流程是一样的么?陕西榆林市快手开户快不快?陕西快手信息流广告开户需要几天?河北藁城市怎么做快手广告推广?河北快手开屏广告可以投放么?河北遵化市如何做快手推广?河北快手开户需要多长时间?河北南宫市快手广告开户需要提供哪些资质?河北安国市怎么做快手短视频广告推广?

相关文章

评论列表

发表评论:
验证码

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。