1.微信号码包查询
请求接口：https://ad.e.kuaishou.com/rest/openapi/v2/gemini/wechat/pack/list
请求方式：POST
数据格式：JSON
请求参数 |
快手开户时间 | |||
字段 |
类型 |
是否必填 |
说明 |
备注 |
advertiser_id |
long |
必填 |
快手广告主ID |
在获取access_token的时候返回 |
page |
int |
选填 |
请求的页码 |
默认为1 |
page_size |
int |
选填 |
每页行数 |
默认为20，上限500 |
pack_ids |
long[] |
选填 |
微信号码包id集合 |
返回参数 |
快手广告投放平台 | ||
字段 |
类型 |
说明 |
备注 |
code |
int |
返回码 |
|
message |
string |
返回信息 |
|
data |
JSON |
||
total_count |
int |
数据的总行数 |
|
details |
JSON |
数据明细信息 |
|
id |
long |
微信号码包id |
|
pack_name |
string |
微信号码包名称 |
|
item_list |
JSON |
线索号码明细信息 |
WechatItem列表 |
related_page_ids |
long[] |
使用了当前微信号包的落地页id列表 |
WechatItem |
快手全国广告代理商 | |
字段 |
类型 |
说明 |
id |
long |
微信号码记录id |
wechat_id |
string |
微信id |
wechat_nickname |
string |
微信昵称 |
wechat_account_type |
int |
微信账号类型 |
wechat_app_id |
string |
微信appId |
use_count |
int |
复制次数
|
related_page_ids |
long[] |
使用了当前微信号的落地页id列表 |
请求样例 |
curl --location --request POST 'https://ad.e.kuaishou.com/rest/openapi/v2/gemini/wechat/pack/list' \ --header 'access-token: 2001269897942cf166354de6d5c444b6' \ --header 'Content-Type: application/json' \ --data-raw '{ "advertiser_id": 20000993, "pack_ids": [ 165894775509420491, 165896647561513419 ] }' |
返回样例 |
{ "code": 0, "message": "OK", "data": { "total_count": 2, "details": [ { "id": 165896647561513419, "pack_name": "小跳蛙号码包", "item_list": [ { "id": 165893015545579979, "wechat_id": "hhhggg1202", "wechat_nickname": "小跳蛙", "wechat_app_id": "", "wechat_account_type": 1, "use_count": 0, "related_pack_ids": [ 165894775509420491, 165896647561513419 ], "related_page_ids": [] } ], "related_page_ids": [] }, { "id": 165894775509420491, "pack_name": "小跳蛙号码包", "item_list": [ { "id": 165893015545579979, "wechat_id": "hhhggg1202", "wechat_nickname": "小跳蛙", "wechat_app_id": "", "wechat_account_type": 1, "use_count": 0, "related_pack_ids": [ 165894775509420491, 165896647561513419 ], "related_page_ids": [] }, { "id": 165895207728253387, "wechat_id": "hhhggg12021", "wechat_nickname": "小跳蛙1", "wechat_app_id": "", "wechat_account_type": 1, "use_count": 0, "related_pack_ids": [ 165894775509420491 ], "related_page_ids": [] } ], "related_page_ids": [] } ] } } |
2. 返回码
（1） 成功返回
code |
msg |
描述 |
0 |
OK |
成功 |
（2） 通用返回
code |
msg |
描述 |
400000 |
系统繁忙 |
不可知错误 |
400001 |
请求过于频繁 |
|
400002 |
没有权限进行相关操作 |
没有权限进行相关操作 |
（3） 参数相关
code |
msg |
描述 |
401000 |
参数错误 |
部分参数缺失 |
401001 |
参数格式错误 |
参数不符合格式要求 |
401002 |
选取时间跨度过大 |
日期跨度不符合要求 |
401003 |
选取起始时间超过允许范围 |
|
401004 |
选取起始时间晚于结束时间 |
|
401005 |
名称重复 |
（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错误 |
（6）并发次数
①单个APP_ID数据查询请求次数限制1,000次／分钟——包括所有授权码；
②系统整体支持的请求次数限制为10,000次／分钟——包括所有APP_ID。
