跳转至

开放平台应用开发指南

文档ID: 401714
页面标识: 4852036ba63c13df7f5fd2ddc38169581614263613785
更新时间: 1724730117123
浏览量: 11670


1.选择应用类目

在开发者资质审核通过后,即可创建应用,可根据当前的开发者角色,点击创建应用后选择对应的应用类目。进入到“控制台-应用中心”,点击创建应用卡片

1.1 第三方开发者

如果您是第三方开发者,点击右上角控制台-应用中心,跳转如下创建应用界面。

目前平台支持店铺管理、营销管理、客服管理、装修市场、店铺服务五大一级类目,打单发货、商品管理等共计十七个二级类目。如果没有您要创建的应用类目,可以发邮件至open@kuaishou.com联系我们咨询开通计划。

1.2 商家开发者

如果您是快手商家开发者,点击右上角控制台-应用中心,跳转如下创建应用界面。

1.3 快分销团长

如果您是快分销团长开发者,点击右上角控制台-应用中心,跳转如下创建应用界面。

1.4 快赚客

如果您是快赚客,点击右上角控制台-应用中心,跳转如下创建应用界面。

1.5 平台合作伙伴

如果您是平台合作伙伴开发者,点击右上角控制台-应用中心,跳转如下创建应用界面。

2.填写应用信息

请选择您要创建的应用类目,点击“下一步”按钮,跳转到如下应用信息填写页面,请依次按照要求进行信息填写完善应用信息。

应用创建完成通过审核后,平台会分配appKey、appSecret和signSecret,即可以进行API的调用。应用名称不允许包含“快手”、“官方”等字段,可以根据应用功能起名;

MRD文档和PRD文档下载模板后对按照模板内容做简要的说明并上传;回调地址即用户完成授权后跳转的地址,工具类应用则为使用的网址,集成对接类应用可以使用官方地址;其中应用名称、应用说明、应用图标、回调地址和官网地址信息,在应用创建完成后也支持在线更新。

image.png

3.提交审核

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

注:应用安全扫描为系统自动扫描,非人工审核。系统将于4-6小时内自动完成安全扫描,请您耐心等待。

4.申请权限包

如果应用信息审核失败,请根据审核失败原因进行修改并再次提交审核;如果应用信息审核通过,您可以看到appKey、appSecret、signSecret等信息。系统只会根据您申请的应用类目授予您的应用默认接口访问权限包,对于您需要的但是未获取的权限包可以点击“申请”,再点击二次确认弹窗内的“确认”,此时该权限包会处于申请中状态,我们一般会在1-3个工作日内进行审核,请耐心等待。

image.png

5.应用开发

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

image.png

6.用户对应用授权

6.1 测试用户对应用授权

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

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

6.2 正式用户对应用授权

商家后台、快分销自研团长和快赚客类应用 :在应用上线后即可在授权用户管理列表中添加正式用户,开发者可将授权链接分享给正式用户,正式用户打开授权链接确认授权后即会建立授权关系。若要解除授权关系,可以在此列表中对测试用户操作“解除授权”或“删除”。

第三方开发者创建的三方应用 :在上线后需要上架服务市场进行授权管理。

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

7.开发者工具和文档

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

image.png

image.png

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

image.png

8.数据看板和监控

数据看板可以帮助您统计指定应用中单个接口或者所有接口的调用量与成功率。您需要关注自己APP对API的调用数据,如果出现成功率低的原因,请先自己根据返回码说明进行排查,如排查过后仍有问题,请发邮件到open@kuaishou.com联系反馈给我们。为了提高您的使用体验,平台也会尽可能地提高API的稳定性。

loadimage (8).png

9.应用扫描

测试开发完成后,点击“提交扫描”进行安全扫描,安全扫描为平台安全系统对应用回调地址内容进行自动扫描,时间为4~6小时,非人工审核。

image.png

image.png

安全扫描未通过会返回原因,请根据审核建议进行优化完善应用再次提交扫描。

10.应用上线

安全扫描通过后可以点击“提交上线”。

(1)如果您的应用是自用型应用,应用上线即能使用。

loadimage (13).png

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

为保证上架服务质量,上架审核需要发送邮件申请:

邮件名称:「xx应用」上架申请

内容:

1)应用名称

2)appkey

3)企业名称

4)说明上架原因

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

image.png

13.如果您在应用开发的过程中有其他疑问,请发邮件到open@kuaishou.com,我们一般会在1-3个工作日内给予回复!