注意：仅营销版（及以上版本）支持字节小程序

暂时不支持 在线销售功能，没有支付功能

一.注册账号

注册并登陆

在开发者平台 https://developer.toutiao.com/  中点击右上角的「快捷登录」进行帐号注册。

申请小程序

注册帐号成功后，系统会自动提示进行小程序申请。点击自动弹出的「申请」按钮，即可进入小程序申请页面。（若此次未申请，之后可通过页面中的「进入开发者平台」进入）

在该页面的「选择类型」条目下选择「小程序」类型，后续内容根据具体情况各自补充。

小程序申请发出后，字节小程序将在两个工作日内通过您注册时的 手机号 以及 邮箱 给予您答复。若您收到邀请信息，说明您的产品已经通过，可以在后台进行接入。

注意事项

• 注册后该账号就是后续提交小程序的账号，手机号等信息请如实填写；

• 在必填信息中， 申请注册的公司主体信息请填写完整 ，请勿填写简称，小程序简介尽量与产品功能相关（后续可修改）；

• 在选填信息中， 尽量不要空白 ，如实填写相关情况。

二.创建小程序

填写信息

进入开发者平台，登录帐号后，点击「进入开发者平台」，点击「创建一个小程序」。

点击创建小程序，即进入下图所示页面，按提示输入相关内容。

点击下一步之后需进行账号手机动态验证，验证成功即可进入小程序后台。

根据小程序开发引导，完整小程序对应的基础信息填写，请如实填写相关信息。

特别注意：基本信息中的分类请如实填写，将影响小程序的推荐精准度；小程序服务类型请如实填写，不同类型需上传不同的服务资格证明。

三.主体认证

创建完成后，进入小程序总览页，点击「去认证」，进行主体认证。

主体身份选择

目前支持的主体身份类型：企业开发者，个人开发者。

身份选择后，不可进行修改。请开发者根据自身情况时间选择。

企业开发者

填写管理员个人信息：

填写企业信息：

填写审核联系人信息及发票信息：

企业认证审核服务费可开具票面内容为【技术服务费】的增值税普通发票（电子票），发票抬头为当前认证公司全称（不可更改）。 缴费之日起30个工作日内开具。发送到您所留的邮箱。

支付审核费用，进入审核流程：

企业开发者需支付300元/次的审核服务费用。这是用户基于字节跳动提供的资质审核服务而支付的一次性费用，用户每申请一次认证服务需要支付一次审核服务费。无论认证成功或失败，都需要支付审核服务费。

等待审核结果，企业开发者的结果将在1~3个工作日反馈给开发者。 审核期间，可正常开发、配置小程序信息。

个人开发者：

填写管理员信息：

等待审核结果，结果将在1~3个工作日反馈给开发者。 审核期间，可正常开发、配置小程序。

四.开发前准备

添加协作者/管理员

进入协作栏，点击添加按钮即可添加管理员/协作者，点击添加之后会出现邀请页面。

没有注册过的用户可通过邮箱邀请，通过以下权限管理选择给其添加的权限，点击完成则添加成功，受邀者邮箱会收到信息，从邮箱点击进行操作即可。

获取 Appid、AppSecret

登录头条开发者平台，选择需要获得的小程序，进入对应的小程序「开发」栏，选择开发。

设置服务器域名

进入小程序页面，点击开发栏，即可看到服务器域名配置区域。

• request 合法域名

• socket 合法域名

• uploadFile 合法域名

• downloadFile 合法域名

企业资质的开发者可以开通 webview 域名「必须通过域名校验」。

五.开发与调试

开发

请直接使用小程序开发者工具进行开发，最新版下载地址：开发者工具下载

具体能力说明可查看：官方开发文档

有问题请在论坛中查询及反馈：字节跳动开放社区

操作流程

在建站小程序编辑器右上角点击生成、填写好之前获取的Appid和AppSecret等。

点击保存后弹出下载代码界面，下载后解压文件。

打开字节跳动开发者工具，导入刚刚解压的文件。

                                                              

上传时版本号 按以下格式填写 0.0.1  不能有 字母 只能是数字

                                                

调试流程

当小程序更新完成后，将会生成对应的二维码，可扫码进行真机调试。

真机调试步骤如下：

• 手机重新安装今日头条线上最新版，kill 掉进程重启，打开 App 左右滑动 tab 页，正常浏览 app 几秒；

• 使用安装测试 App 的手机扫码（测试某个应用，则使用对应的应用扫码），扫码后 Android 下使用 Chrome、iOS 使用 Safair 打开对应网址，点击打开小程序即可唤起，请务必使用 Chorme 和 Safair ，不然不能正常唤起；

• 注意事项：

• 如果打不开小程序，请 kill 掉进程，重启 app 再试一次，若还有问题，请去开放社区反馈；

• 如果显示 App 版本不支持建议确认 App 版本，手机内是否有多个头条 App。建议全部卸载后重新安装；

• 如果提示系统版本不支持，检查手机系统版本，安卓大于等于 5.0，iOS 高于 9.0。

登录及获取用户信息

如果需要获取用户信息（getUserinfo 文档：获取已登录用户的相关信息），调用之前那请务必使用 login（文档：获取临时登录凭证）。

由于头条用户存在未登录情况，使用 login 及 getUserinfo时，需要兼容未登录用户的情况，避免出现未登录用户反复弹出登录框，不能进入小程序的情况。

请依据你的小程序设计需要来合理选择是否调用获取 getUserinfo 。

部分功能接入说明

• 内容安全检测：有评论等功能的小程序开发者请重视
  

• 游客登录功能：开场调用登录行为时，force 传 false 将不会调起登录框

六.审核流程

上传

当测试完成，小程序的功能和体验都较为完整时，在开发中工具中点击「上传」按钮，一键上传代码包。

提审

在开发者工具上完成上传后，登录开发者平台，可以在小程序详情页的「发布」中查看到上传的测试版本，填写当前版本信息并上传三张小程序内容截图，完成提审，审核将会在 1-2 个工作日完成。

注： 版本号应符合字节跳动小程序 字节跳动小程序运营审核规范

可以在「审核版本」中看到正在审核的小程序版本及审核状态，若审核不通过，会显示未通过原因（蓝字为相关截屏和截图信息）。审核状态显示通过后，方可发布小程序上线。

特别提醒：

• 小程序在提审前会有自测环节，为了保证通过率，请开发者提审前通过自测环节进行自查；

• 在审核过程中，开发者请遵循后台中的提示进行操作补全对应信息；

• 小程序首次上线前的审核都需进行 qa 回归，预计在 1-2 个工作日；

• 当小程序提审后，务必于后台配置"安全域名"，不然将影响小程序上线，安全域名必须为 https://；

• 目前的审核是基于双端审核，即头条端和抖音端，若只需上线一端，请在更新日志中备注清楚，方便加快审核速度。

七.发布小程序

审核通过后，发布按钮亮起，开发者点击发布，小程序即可入线上版本。

设置搜索关键词与分享

当发布未配置搜索关键词与分享内容版本时，会弹出提示与跳转地址，点击【前往配置】。

如果已有搜索关键词和分享内容，想要查看或进行修改，可以在小程序详情页中的【设置】进行相应的配置。配置搜索关键词：提交的搜索关键词应符合 小程序关键词搜索。

发布上线

通过审核并且配置过搜索关键词与分享内容的版本，在【审核版本】中点击发布即可将小程序发布至线上。

可以在小程序列表中看到相应小程序线上的版本号。