快手对接指南

2026-10-15 14:29| 发布者: 万红刚| 查看: 4| 评论: 0

摘要: 快手对接指南1.适用范围本文适用于通过观远连接器接入快手电商开放平台（快手小店）数据。需先取得快手电商开放平台应用的AppKey、AppSecret、SignSecret和所需接口权限包。2.获取快手平台资质2.1创建应用登录快手电 ...

1. 适用范围

本文适用于通过观远连接器接入快手电商开放平台（快手小店）数据。需先取得快手电商开放平台应用的 App Key、App Secret、Sign Secret 和所需接口权限包。

登录快手电商开放平台，完成开发者资质审核后，进入“控制台 → 应用中心”创建应用。根据实际业务选择应用类目，填写应用信息并提交审核。

快手开放平台应用创建页和回调地址输入框

图：快手官方开发指南的应用创建页面。自行创建应用时，回调地址需配置为 https://apiconnector.guandata.com/auth-callback?platCode=KS，提交前请核对当前连接器的回调地址。查看官方应用创建说明。

应用审核通过后，在“控制台 → 应用中心 → 应用详情”查看 appKey、appSecret、signSecret。同页检查已获得的权限包，缺少所需权限时点击“申请”并等待审核。

快手应用详情页中三个密钥和权限包的位置

图：快手官方开发指南的应用详情示例。页面上方依次显示 appKey、appSecret、signSecret，下方列出权限包及申请状态；示例凭证已遮挡。查看官方密钥与权限包说明。

上述信息的位置见快手官方应用开发指南。App Secret 和 Sign Secret 只应填入受控表单，不要放入公开截图或文档。

进入观远连接器的数据账户管理，点击“新增数据账户”，所属平台选择“快手”。

新增快手数据账户表单及全部必填字段

图：连接器表单示例，App Secret 已遮挡。

快手平台信息	连接器字段	必填	官方获取入口／说明
自行命名	账户名称	是	填写便于识别的名称。
无需在快手平台获取	店铺ID `customer_id`	是	当前连接器中是用户自定义的账户标识，用于区分不同授权店铺；不要求填写快手后台发放的店铺编号。不同账户请使用不同标识。
`appKey`	App Key `app_key`	是	查看官方应用详情中的 appKey
`appSecret`	App Secret `app_secret`	是	查看官方应用详情中的 appSecret
`signSecret`	Sign Secret `sign_secret`	是	查看官方应用详情中的 signSecret
应用已获批的权限包	授权权限范围 `scope`	是	选择本次读取数据所需且应用已获批的权限包。查看官方权限包申请说明

填写字段、选择权限范围后点击“立即授权”，由有权限的店铺账号在快手授权页确认。返回连接器，确认状态为“已完成”，再点击“确定”保存。第三方应用的正式用户授权可能还涉及服务市场上架或订购，详见官方正式用户授权说明。

现象	核对方式
找不到三个密钥	确认开发者资质及应用信息审核通过，打开对应应用的“应用详情”。
授权范围不可用或接口无权限	检查相应权限包是否已获批，选择与实际数据读取相符的范围。
授权后仍显示“未完成”	检查店铺账号是否完成授权、应用回调地址是否正确，以及第三方应用是否满足正式授权条件。