一.注冊賬號

注冊并登陸

在開發者平臺 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://；

• 目前的審核是基于雙端審核，即頭條端和抖音端，若只需上線一端，請在更新日志中備注清楚，方便加快審核速度。

七.發布小程序

審核通過后，發布按鈕亮起，開發者點擊發布，小程序即可入線上版本。

設置搜索關鍵詞與分享

當發布未配置搜索關鍵詞與分享內容版本時，會彈出提示與跳轉地址，點擊【前往配置】。

                                                                                          

如果已有搜索關鍵詞和分享內容，想要查看或進行修改，可以在小程序詳情頁中的【設置】進行相應的配置。配置搜索關鍵詞：提交的搜索關鍵詞應符合 小程序關鍵詞搜索。

                                                                                           

                                                                                           

                                                                                          

                                                                                          

發布上線

通過審核并且配置過搜索關鍵詞與分享內容的版本，在【審核版本】中點擊發布即可將小程序發布至線上。

                                                                                          

可以在小程序列表中看到相應小程序線上的版本號。