快手广告代理商接口《NO.1》

快手广告代理商接口《NO.1》

发布时间：2021-09-05浏览次数：135

1、获取注册地列表

GET/POST /rest/openapi/v1/agent/region/list

请求参数：

字段	类型	说明	是否必填	备注
agent_id	long	代理商id	是	和access_token一致

返回参数：用于在提交快手广告账户信息时（接口9）传入licence_location字段，格式是"xx省-xx市"

2、获取产品列表

GET/POST /rest/openapi/v1/agent/product/list

请求参数：

字段	类型	说明	是否必填	备注
agent_id	long	代理商id	是	和access_token一致

返回参数：用于在提交快手推广账户信息时（接口9）传入product_name字段，但product_name字段填写的参数也可以不在该列表中

字段	类型	说明	备注
details	string[]	产品列表	已有的产品列表

3、获取行业列表

GET/POST /rest/openapi/v1/agent/industry/list

请求参数：

字段	类型	说明	是否必填	备注
agent_id	long	代理商id	是	和access_token一致

返回参数：

二级行业id用于在提交快手账户信息时（接口9）传入industry_id字段

Industry

字段	类型	说明	备注
industry_id	long	行业id	不在children中，是一级行业id，在children中，是二级行业id
industry_name	string	行业名称	一级行业名称或二级行业名称
industry_note	string	行业备注
industry_cert	string	资质备注
children	Industry[]	二级行业列表

4、获取账号信息和快手开户资质

GET/POST /rest/openapi/v1/agent/advertiser/cert/get

请求参数

返回参数

只返回账号信息和快手开户资质（cert_category为1、2、3、4）

用于更新账号信息和快手开户资质（接口9）

AdBpCert

字段	类型	说明	备注
common_cert_list	AdBpCommonCert[]	当前开户资质列表

AdBpCommonCert

通用资质

字段	类型	说明	备注
cert_id	long	资质编号
url	string	资质文件url
cert_category	int	资质类型	1-营业执照，2-ICP备案，3-投放承诺函，4-行业资质，5-投放资质
file_token	string	资质文件标识	用于接口9、10提交资质的file_token
expire_time	string	资质有效期	资质过期时间，格式如： yyyy-MM-dd 如果是空字符串，表示永久有效
review_status	int	资质审核状态	0-待审核，1-审核中，2-审核通过，3-审核拒绝
review_detail	string	资质审核结果	如果资质审核状态是审核拒绝，显示审核拒绝的原因
replace_cert	AdBpCommonCert	要替换的资质
expire_status	int	过期状态	1-有效，2-即将到期(30天内），3-已过期