跳转至

新手指南

文档ID: 401715
页面标识: 7964da40b7365bb46e35d69cae361cb21620701397031
更新时间: 1724738360289
浏览量: 13873


1.账号注册

1.1 注册/登录

访问快手电商开放平台跳转到快手电商开放平台首页

1.1.1 注册

1.1.2 登录

若已有快手账号,点击右上方“登录”,

注:如账号登录遇到问题,可先查询账号登录常见问题

1.2 签约协议

首次登录成功后,自动跳转进入到开发者注册协议页面(开发者注册协议),进行在线协议签约,浏览完协议内容后,勾选“同意”,点击“下一步”按钮。

首次登录成功后,自动跳转进入到开发者注册协议页面,进行在线协议签约,浏览完协议内容后,勾选“同意”,点击“下一步”按钮。

1.3 角色选择

开放平台的开发者目前支持4种身份类型:第三方开发者、商家开发者、快分销团长、快赚客、平台合作伙伴,同一个企业主体资质、同一个快手ID可注册多个开发者类型,但需保证邮箱全局唯一

注:请参照开发者角色说明,选择不同的业务类型在注册时使用不同类型的快手账号,否则后续无法进行更改。

身份类型 类型描述
第三方开发者 对接快手服务市场的应用开发者,应用开发完成后可上架服务市场供商家购买。目前平台支持店铺管理、营销管理、客服管理、装修市场、店铺服务五大一级类目,打单发货、商品管理等共计十七个二级类目。
商家开发者 对接自有快手小店的应用开发者,应用开发完成后仅供自己的店铺使用。需要使用商家的快手账号登录。
快分销团长 拥有站内撮合能力和研发能力的快分销大团长,用于自有团长账号和平台对接,仅快分销团长身份可申请
快赚客 拥有站外渠道和研发能力的快赚客,用于自有快赚客账号和平台对接,仅快赚客身份可申请。
平台合作伙伴 对接快手官方平台的软件提供商或服务供应商,与快手达成业务合作。当前实行邀请入驻政策。

1.4 填写资料

点击“下一步”后跳转如下资料填写页面,请依次按照要求进行信息完善,包括法人信息、企业信息和管理员信息,请开发者提前准备好企业营业执照。

信息填写完成,并核对无误后,点击页面底部“提交审核”按钮。

1.5 提交审核

系统提示提交成功,自动跳转至审核页面,请耐心等待管理员审核,我们一般会在1-3个工作日内进行审核,审核结果会通过邮件告知。如果提示审核未通过,请根据提示原因修改入驻资料后,再次提交审核。

image.png

注:详细开发者入驻流程可参考开放平台入驻指南

2.应用创建

2.1选择类目

a.第三方开发者【服务市场应用】

若是第三方开发者,点击右上角控制台-应用中心,跳转如下创建应用界面。目前平台支持店铺管理、营销管理、客服管理、装修市场、店铺服务五大一级类目,打单发货、商品管理等共计十七个二级类目。

b.商家开发者【商家后台应用】

开发者资质审核通过之后,若为商家开发者,点击右上角控制台-应用中心,跳转如下创建应用界面,点击“下一步”。

c.快分销团长【快分销应用】

开发者资质审核通过之后,若为快分销团长开发者,点击右上角控制台-应用中心,跳转如下创建应用界面,点击“下一步”。

d.快赚客【快赚客应用】

开发者资质审核通过之后,若为快赚客开发者,点击右上角控制台-应用中心,跳转如下创建应用界面,点击“下一步”。

e.平台合作伙伴开发者【平台对接应用】

开发者资质审核通过之后,若为平台合作伙伴开发者,点击右上角控制台-应用中心,跳转如下创建应用界面,点击“下一步”。

2.2 完善信息

选择需要创建的应用类目,点击“下一步”按钮,跳转到如下应用信息填写页面,请依次按照要求进行信息填写完善应用信息。应用创建完成通过审核后,平台会分配appKey、appSecret和signSecret,即可以进行API的调用。应用名称不允许包含“快手”、“官方”等字段,可以根据应用功能起名;MRD文档和PRD文档下载模板后对按照模板内容做简要的说明并上传;回调地址即用户完成授权后跳转的地址,工具类应用则为使用的网址,集成对接类应用可以使用官方地址;其中应用名称、应用说明、应用图标、回调地址和官网地址信息,在应用创建完成后也支持在线更新。

image.png

2.3 提交审核

信息填写完成后,点击 “提交”,应用创建成功即为审核中状态,平台一般会在1-3个工作日内进行审核,并通过邮件告知审核结果。

3.开发测试

3.1 常见说明

3.1.1 授权及API调用

在获取需要的权限包以后,请根据授权说明指引进行授权操作、API调用说明指引进行接口调用开发。

授权过程中若遇到问题,可查询参考应用授权常见问题

API调用过程中若遇到问题,可查询参考API调用常见问题

3.1.1.1授权管理-测试用户

所有类型的应用在创建审核通过后,都可在测试用户管理列表中添加测试用户,将授权链接分享给测试用户后,测试用户可打开授权链接确认授权,即会建立应用和测试用户的授权关系,应用即可进行开发测试。若需要解除授权关系,可以在此列表中对测试用户的主账号或子账号操作“解除授权”或“删除”。测试用户列表最多可以添加5名用户(主账号及其子账号计为一个用户数),每名用户(主账号及其子账号计为一个用户数)在该应用下的天调用流量为2000次,默认授权关系会在10天后自动取消。

注:授权管理-测试用户页提供了对测试用户进行刷新code和复制code的功能,可用于应用测试阶段使用。

3.1.1.2授权管理-授权用户

商家后台类应用在应用上线后即可在授权用户管理列表中添加正式用户,开发者可将授权链接分享给正式用户,正式用户打开授权链接确认授权后即会建立授权关系。若要解除授权关系,可以在此列表中对测试用户操作“解除授权”或“删除”。非商家后台类型的三方应用在上线后需要至服务市场进行服务管理。

注:授权管理-授权用户页用于管理正式用户的授权,不提供该功能,请按照授权说明文档在用户确认授权后获取code。

3.1.2 SDK使用

快手开放平台提供了Java版本的SDK(开发者可以根据SDK使用说明指引下载使用SDK)、API测试工具(文档中心-API文档中每个API文档的右上角点击进入)、消息测试工具(文档中心-消息文档中每个消息API文档的右上角点击进入)。

image.png

image.png

3.1.3 消息推送

消息推送服务可以帮助您高效获取订单、商品、售后三类重要数据变更消息,具体使用说明请参考消息服务说明

image.png

3.1.4 数据看板

数据看板可以统计指定应用中单个接口或者所有接口的调用量与成功率。如果出现成功率低的现象,可以根据返回码说明进行排查。

loadimage (8).png

3.2 常见解决方案

对接开放平台可参考以下常见模块的解决方案:

订单解决方案:订单

商品解决方案:商品

售后解决方案:售后

快分销解决方案:快分销

智能客服解决方案:智能客服

4.应用上线

4.1 安全扫描

测试开发完成后,点击“提交扫描”进行安全扫描。

安全扫描中若遇到问题,可查询参考安全扫描常见问题

image.png

安全扫描提交后,应用进入安全扫描中状态。

image.png

工作人员会在收到邮件1-3个工作日内完成审核,审核结果会通过邮件告知。

image.png

4.2 应用上线

商家自用型应用,应用上线即能使用。

loadimage (13).png

注:商家应用申请详细流程可参考开放平台应用开发指南

5.应用上架

如果是第三方服务应用,在应用上线后点击创建服务或者前往服务管理跳转到服务商控制台,服务商入驻流程请参考服务市场入驻指南

image.png