當你的 API 已開發完成並成功偵錯後,Apidog 可讓你輕鬆產生專業文件,並分享給你的團隊、利害關係人或外部開發者。
請依照以下步驟產生並分享你的 API 文件:
開啟你的 Apidog 專案
從側邊欄切換至 Share Docs 模組
在分享設定中完成以下設定:
| 設定 | 說明 | 建議操作 |
|---|---|---|
| 名稱 | 為你的分享提供具描述性的名稱 | 使用專案名稱 + 版本(例如:"Pet Store API v1.2") |
| 環境 | 選擇要包含哪些環境 | 選取所有環境,以取得完整文件 |
| 存取權限 | 設定可見性權限 | 根據你的受眾選擇適當的存取層級 |
你的文件包含強大的功能:
互動式 API Explorer:在左側目錄樹中瀏覽端點
Try It Out:直接從文件傳送即時請求
程式碼產生:產生請求程式碼片段和資料模型程式碼
環境切換:測試不同的 API 環境
Apidog 為你的文件提供額外的自訂選項:
| 功能 | 說明 | 使用情境 |
|---|---|---|
| 自訂版面配置 | 修改文件結構和外觀 | 品牌一致性、使用者體驗最佳化 |
| 自訂網域 | 使用你自己的網域名稱 | 專業呈現、品牌識別 |
| 自訂 URL | 建立易記且有意義的 URL | 行銷、輕鬆分享、SEO 效益 |
| 存取控制 | 設定細緻的權限 | 內部團隊、外部合作夥伴、公開存取 |
INFO
如需進階發布選項的詳細資訊,請參閱 發布 API 文件 指南。