# 基础

接口名称请求路径描述
获取接口调用凭据/cgi-bin/token本接口用于获取获取全局唯一后台接口调用凭据(Access Token),token 有效期为 7200 秒,开发者需要进行妥善保存,使用注意事项请参考此文档
获取稳定版接口调用凭据/cgi-bin/stable_token本接口用于获取获取全局唯一后台接口调用凭据(Access Token),token 有效期为 7200 秒,但此接口和 getAccessToken 互相隔离,
查询API调用额度/cgi-bin/openapi/quota/get本接口用于查询服务端接口的的每日调用接口的额度,调用次数,频率限制
重置API调用次数/cgi-bin/clear_quota本接口是通过access_token清空服务端接口的每日调用接口次数
使用AppSecret重置API调用次数/cgi-bin/clear_quota/v2本接口是通过AppSecret清空服务端接口的每日调用接口次数
重置指定API调用次数/cgi-bin/openapi/quota/clear本接口使用 access_token 来重置指定接口的每日调用次数
获取微信API服务器IP/cgi-bin/get_api_domain_ip该接口用于获取微信 api 服务器 ip 地址(开发者服务器主动访问 api.weixin.qq.com 的远端地址)
获取微信推送服务器IP/cgi-bin/getcallbackip该接口用于获取微信推送服务器 ip 地址(向开发者服务器推送信息的微信服务器来源地址)
网络通信检测/cgi-bin/callback/check为了帮助开发者排查回调连接失败的问题,提供这个网络检测的API

# 商品

接口名称请求路径描述
获取商品基础详情/channels/ec/league/headsupplier/productdetail/get你可以在本接口获取最详细的通用商品信息(例如商品销量、价格、图片等);商品推广相关的参数(如推广链接等)请分别在推客带货和达人带货接口中获取
获取订阅的商品列表/channels/ec/league/headsupplier/subscription/getsubscribe通过该接口,带货机构可获取已订阅的商品, 订阅的商品分以下两种情况
商品订阅/channels/ec/league/headsupplier/subscription/subscribe通过该接口,带货机构可对指定商品进行订阅 注:订阅后,商品的基础信息或者计划信息变化时会通过回调的方式通知机构
取消商品订阅/channels/ec/league/headsupplier/subscription/unsubscribe通过该接口,带货机构可对指定商品进行取消订阅

# 类目

接口名称请求路径描述
获取所有类目/channels/ec/category/league/all可通过该接口获取全部的类目信息、类目的资质信息、商品资质信息

# 订单

接口名称请求路径描述
获取佣金单详情/channels/ec/league/headsupplier/order/get可通过该接口获取佣金单详情
获取佣金单列表/channels/ec/league/headsupplier/order/list/get可通过该接口获取佣金单列表

# 资金

接口名称请求路径描述
获取机构账户余额/channels/ec/league/headsupplier/funds/balance/get可通过该接口获取账户余额
获取资金流水详情/channels/ec/league/headsupplier/funds/flowdetail/get可通过该接口获取获取资金流水详情
获取资金流水列表/channels/ec/league/headsupplier/funds/flowlist/get可通过该接口获取资金流水列表

# 商家合作

接口名称请求路径描述
获取合作小店详情/channels/ec/league/headsupplier/shop/get可通过该接口获取合作小店详情
获取合作小店列表/channels/ec/league/headsupplier/shop/list/get可通过该接口获取小店列表
获取店铺自定义的推广锁客时效/channels/ec/league/headsupplier/lockcustomertime/getlocktime获取指定店铺对机构设定的锁客时效以及默认时效,店铺设置的时效的优先级高于默认时效

# 达人带货

# 橱窗管理

接口名称请求路径描述
添加机构商品到橱窗/channels/ec/league/headsupplier/window/add可通过该接口添加机构商品到橱窗
获取达人橱窗授权链接/channels/ec/league/headsupplier/windowauth/get可通过该接口获取达人橱窗授权链接
获取达人橱窗授权状态/channels/ec/league/headsupplier/windowauth/status/get可通过该接口获取达人橱窗授权状态
查询橱窗上机构商品详情/channels/ec/league/headsupplier/window/getdetail可通过该接口查询橱窗上机构商品详情
查询橱窗上机构商品列表/channels/ec/league/headsupplier/window/getall可通过该接口查询橱窗上机构商品列表
从橱窗移除机构商品/channels/ec/league/headsupplier/window/remove可通过该接口从橱窗移除机构商品

# 商品获取

接口名称请求路径描述
获取合作商品列表/channels/ec/league/headsupplier/cooperativeitem/list/get可通过本接口查询,你在选品广场添加过的商品或者通过机构添加合作商品接口添加过的商品
获取机构选品广场商品列表/channels/ec/league/headsupplier/selectionproducts/list/get1.带货机构如果要做带货达人和商家的撮合业务,可以通过本接口拉取属于机构的联盟公开商品池
获取商品推广参数详情/channels/ec/league/headsupplier/item/promotiondetail/get可通过该接口,获取合作商品的推广参数(如佣金率、推广链接等);商品的基础信息(如商品图,类目等信息)请通过 获取商品基础详情 接口获取
配置达人佣金率/channels/ec/league/headsupplier/subitem/add可通过该接口为“机构分配达人佣金”的商品分配达人佣金,分配完后,可以把链接给到达人带货
获取机构配置达人佣金计划列表/channels/ec/league/headsupplier/subitem/list/get可通过该接口,获取完成达人佣金率配置后的商品推广列表,获取推广链接给到带人带货
机构添加合作商品/channels/ec/league/headsupplier/cooperativeitem/add可通过该接口,添加从机构选品广场列表中获取的商品
机构给帮卖机构供货/channels/ec/league/headsupplier/secondheadsupplieritem/add机构给帮卖机构供货接口,创建对应机构管理页面的“机构推广”
机构获取已添加的推广计划/channels/ec/league/headsupplier/secondheadsupplieritem/getlist机构获取添加过的推广计划,对应机构管理页面上的“机构推广”
机构更新或删除已添加的推广计划/channels/ec/league/headsupplier/secondheadsupplieritem/update机构更新或删除已添加的推广计划,对应机构管理后台页面的“机构推广-普通计划/定向计划”里面的修改佣金率,或者结束推广

# 推客带货

# 账号信息

接口名称请求路径描述
获取推客的注册状态以及和机构的绑定状态/channels/ec/promoter/get_promoter_register_and_bind_status可通过该接口,可获取到当前推客,在推客平台上的注册状态,以及和当前机构的绑定状态
设置推客的的分佣类型和比例信息/channels/ec/promoter/set_sharer_commission_info可通过该接口,可设置推客的的分佣类型和比例信息
获取机构绑定的推客信息/channels/ec/promoter/get_bind_sharer_list获取当前机构绑定的推客信息,也可在 微信小店·联盟带货机构 - 推客带货 - 推客合作 查看
机构解绑推客/channels/ec/promoter/headsupplier_unbind_promoter机构可以通过这个接口,解绑不再合作的推客
获取合作的小店列表/channels/ec/promoter/get_bind_shop_list获取合作的小店列表,也可在 微信小店·联盟带货机构 - 关系管理 - 合作商家 查看
获取合作小店的关联账号列表/channels/ec/promoter/get_bind_shop_promoter_list可通过该接口,可获取合作小店的关联账号列表
获取合作的带货者列表/channels/ec/promoter/get_bind_talent_list获取合作的带货者列表

# 商品获取

接口名称请求路径描述
获取推客对某个商品的推广短链/channels/ec/promoter/get_product_promotion_link_info可通过该接口,可获取到推客对某个商品的推广短链
获取推客对某个商品的推广二维码/channels/ec/promoter/get_product_promotion_qrcode_info可通过该接口,可获取到推客对某个商品的推广二维码
获取可推广的商品详情/channels/ec/promoter/get_promote_product_detail可通过该接口获取推客商品的商品详情 启用新多级类目树提示:旧的类目树固定为三级类目结构,新的类目树为多级类目结构,过渡期间,新旧类目树兼容使用,请开发者尽快切换
获取可推广的商品id列表/channels/ec/promoter/get_promote_product_list相关文档:机构商品变更通知
获取某个推客某个商品的内嵌商品卡片product_promotion_link/channels/ec/promoter/get_promoter_single_product_promotion_info可通过该接口,获取某个推客某个商品的内嵌商品卡片productpromotionlink,长期有效
获取推客的某个商品的推广分佣比例/channels/ec/promoter/get_sharer_product_commission_info通过该接口,可获取到推客的某个商品的推广分佣比例
设置推客的单个商品的分佣比例信息/channels/ec/promoter/set_sharer_product_commission_info可通过该接口,可设置推客的单个商品的分佣比例信息
获取商品推广统计数据/channels/ec/league/headsupplier/promoteraction/getproductsharestats可通过该接口获取推客推广商品的相关数据——商品推广的转发和点击统计数据

# 机构推广券

接口名称请求路径描述
获取定向券ID列表/channels/ec/promoter/get_cooperative_coupon_list可通过该接口,可获取定向券ID列表
获取券ID对应的详情内容/channels/ec/promoter/get_coupon_detail可通过该接口,可获取券ID对应的详情内容
获取某个券ID对应的小程序内嵌微信小店优惠券推广参数/channels/ec/promoter/get_coupon_promoter_share_link可通过该接口,可获取某个券ID对应的小程序内嵌微信小店优惠券推广参数,长期有效
获取某个券ID对应的推广二维码/channels/ec/promoter/get_coupon_qr_code可通过该接口,可获取某个券ID对应的推广二维码
获取某个券ID对应的推广短链/channels/ec/promoter/get_coupon_short_link可通过该接口,可获取某个券ID对应的推广短链
获取公开券ID列表/channels/ec/promoter/get_public_coupon_list可通过接口获取商家设置的机构推广券列表
分发优惠券给其他机构/channels/ec/promoter/set_coupon_to_headsupplier机构将店铺定向给自己的优惠券分发给其他机构
获取分发给其他机构的优惠券/channels/ec/promoter/get_coupon_to_headsupplier获取分发给其他机构的优惠券

# 直播推广

接口名称请求路径描述
获取直播大场保护的提报二维码/channels/ec/league/headsupplier/liveprotection/getqrcode本接口用于为符合条件的机构生成直播大场保护提报二维码,机构可将该二维码分发给指定达人完成报备
获取某个带货者当前直播的带货商品列表/channels/ec/promoter/get_live_commission_product_list可通过该接口,可获取某个带货者当前直播的带货商品列表
获取带货者的直播预约列表/channels/ec/promoter/get_live_notice_record_list可通过该接口,可获取带货者的直播预约列表
为某个推客生成单个直播预约的推广二维码/channels/ec/promoter/get_live_notice_record_qr_code可通过该接口,为某个推客生成单个直播预约的推广二维码
获取直播预约的单个推客的推广预约人数/channels/ec/promoter/get_live_notice_reservation_info可通过该接口,获取直播预约的单个推客的推广预约人数【支持自营、带货的预约直播间】
获取带货者的直播列表/channels/ec/promoter/get_live_record_list可通过该接口,可获取带货者的直播列表
为某个推客生成单个直播的推广二维码/channels/ec/promoter/get_live_record_qr_code可通过该接口,为某个推客生成单个直播的推广二维码
获取小店关联账号的当前直播的自营商品列表/channels/ec/promoter/get_shop_live_commission_product_list可通过该接口,可获取小店关联账号的当前直播的自营商品列表
获取小店关联账号的预约直播列表/channels/ec/promoter/get_shop_live_notice_record_list可通过该接口,可获取小店关联账号的预约直播列表
为推客生成小店关联账号直播预约的推广二维码/channels/ec/promoter/get_shop_live_notice_record_qr_code可通过该接口,为推客生成小店关联账号直播预约的推广二维码
获取小店关联账号的直播列表/channels/ec/promoter/get_shop_live_record_list可通过该接口,可获取小店关联账号的直播列表
为推客生成小店关联账号直播的推广二维码/channels/ec/promoter/get_shop_live_record_qr_code可通过该接口,为推客生成小店关联账号直播的推广二维码
为推客获取小店关联账号直播预约的推广参数/channels/ec/promoter/get_shop_live_notice_promoter_share_link可通过该接口,为推客获取小店关联账号直播预约的推广参数
生成某个带货者的用于直播预约的推广参数/channels/ec/promoter/get_live_notice_promoter_share_link可通过该接口,可生成某个带货者的用于直播预约的推广参数
获取直播预告推广统计数据/channels/ec/league/headsupplier/promoteraction/getlivenoticestats可通过该接口获取推客推广直播预告的相关数据——直播预告的用户预约和用户观看统计数据
获取直播推广统计数据/channels/ec/league/headsupplier/promoteraction/getlivestats可通过该接口获取推客推广直播的相关数据——直播的转发和用户观看统计数据

# 短视频推广

接口名称请求路径描述
获取带货者推广的短视频信息/channels/ec/promoter/get_feed_list可通过该接口,可获取带货者推广的短视频信息
生成某个带货者的某些短视频内嵌短视频卡片需要的feedtoken/channels/ec/promoter/get_feed_promotion_info可通过该接口,可生成某个带货者的某些短视频内嵌短视频卡片需要的feedtoken
获取小店关联账号的短视频列表/channels/ec/promoter/get_shop_feed_list可通过该接口,可获取某个小店关联账号的短视频列表
生成小店关联账号的短视频内嵌小程序推广信息/channels/ec/promoter/get_shop_feed_promotion_info可通过该接口,可生成小店关联账号的短视频内嵌短视频卡片需要的feedtoken

# 公众号文章推广

接口名称请求路径描述
获取小店关联账号的文章列表/channels/ec/promoter/get_shop_mp_article_list可通过该接口,可获取某个小店关联账号的文章列表
获取某个带货者可推广文章列表/channels/ec/promoter/get_talent_biz_article_list可通过该接口,可获取某个带货者可推广文章列表

# 线索订单

接口名称请求路径描述
推客机构获取内容推广的自营商品订单详情/channels/ec/league/headsupplier/clue/get直播间等内容分销场景会有挂自营品的情况,这种情况不会给带货机构分佣,平台给到销售订单线索,达人和机构自行协商
推客机构获取内容推广的自营商品订单列表/channels/ec/league/headsupplier/clue/list/get直播间等内容分销场景会有挂自营品的情况,这种情况不会给带货机构分佣,平台给到销售订单线索,达人和机构自行协商