API · FastadminCMS

## API CMS內容管理系統提供了一個基礎API接口，僅限用于數據遷移或內部接口，不建議用于對接外部API接口。 ## 準備工作使用API接口之前，請務必在后臺->`CMS管理`\->`站點配置`中設置`API密鑰`，設定密鑰后才可以調用API接口。 ## 新增文檔用于新增文檔 ### 請求URL http://www.yoursite.com/addons/cms/api/index ### 請求方法 POST ### 請求參數 | **Body參數名** | 類型 | 必需 | 描述 | 示例 | | --- | --- | --- | --- | --- | | title | string | 是 | 標題 | 標題 | | apikey | string | 是 | API密鑰值,可以從后臺CMS管理站點配置`API密鑰`中獲取 | 無 | | status | string | 是 | 狀態:normal=可見,hidden=隱藏 | normal | | tags | string | 是 | 標簽,Test,自定義 | a,b,c | | content | string | 是 | 內容，支持HTML | 測試內容 | | channel | string | 是 | 分類名稱 | 分類一 | | user | string | 是 | 發布會員,會員的昵稱 | Admin | | price | string | 是 | 付費價格 | 0 | | flag | string | 是 | 標志:index=首頁,hot=熱門,recommend=推薦 | | | views | string | 是 | 瀏覽次數 | 1000 | | createtime | string | 是 | 添加時間,也可以是時間戳 | 2019-10-01 00:00:00 | | user\_id | string | 否 | 發布會員ID,如果有傳user，則優先user | 1 | | channel\_id | string | 否 | 發布會員ID,如果有傳channel，則優先channel | 1 | | 副表字段1 | string | 否 | 副表字段名稱，副表字段必須和欄目的模型字段相匹配 | author | | 副表字段n | string | 否 | 副表字段名稱，副表字段必須和欄目的模型字段相匹配 | author | ### 返回值 ~~~css { "code":"1", "msg":"新增成功" } ~~~ ## 讀取文檔根據文檔ID查詢文章信息 ### 請求URL http://www.yoursite.com/addons/cms/api/archives ### 請求方法 POST ### 請求參數 | **Body參數名** | 類型 | 必需 | 描述 | 示例 | | --- | --- | --- | --- | --- | | id | string | 是 | 文檔ID | 1002 | | apikey | string | 是 | API密鑰值,可以從后臺CMS管理站點配置`API密鑰`中獲取 | 無 | ### 返回值 ~~~javascript { "code":"1", "msg":"讀取成功", "data":{ "id":"1002", "title":"這是一篇測試文章", ...... //其它fa_cms_archives表和副表的字段 } } ~~~ ## 讀取文檔列表根據模型ID和欄目ID查詢文章列表 ### 請求URL http://www.yoursite.com/addons/cms/api/arclist ### 請求方法 POST ### 請求參數 | **Body參數名** | 類型 | 必需 | 描述 | 示例 | | --- | --- | --- | --- | --- | | apikey | string | 是 | API密鑰值,可以從后臺CMS管理站點配置`API密鑰`中獲取 | 無 | | model | int | 是 | 模型ID | 1 | | channel | int | 是 | 欄目ID | 1 | | page | int | 是 | 當前頁 | 1 | | pagesize | int | 是 | 分頁大小 | 10 | ### 返回值 ~~~javascript { "code":"1", "msg":"讀取成功", "data": [ { "id":"1002", "title":"這是一篇測試文章", ...... //其它fa_cms_archives表的字段 }, { "id":"1003", "title":"這是一篇測試文章", ...... //其它fa_cms_archives表的字段 } ] } ~~~ ## 獲取欄目列表用于獲取系統的欄目列表 ### 請求URL http://www.yoursite.com/addons/cms/api/channel ### 請求方法 POST ### 請求參數無 ### 返回值 ~~~css { "code": 1, "msg": "讀取成功", "data": { "14": "網絡工具", "13": "媒體工具", "12": "應用軟件", "10": "智能家居", "9": "移動設備", "8": "智能設備", "6": "硬件", "5": "投資", "4": "安全", "3": "互聯網" } } ~~~ ## 新增評論用于寫入文章評論 ### 請求URL http://www.yoursite.com/addons/cms/api/comment ### 請求方法 POST ### 請求參數 | Body參數名 | 類型 | 必需 | 描述 | 示例 | | --- | --- | --- | --- | --- | | apikey | string | 是 | API密鑰值,可以從后臺CMS管理站點配置`API密鑰`中獲取 | 無 | | type | string | 是 | 類型,page=單頁,archives=文檔 | page | | content | string | 是 | 評論內容 | 測試評論內容 | | aid | string | 是 | 單頁或文檔ID | 1 | | user\_id | string | 是 | 會員ID | 1 | | token | string | 是 | 會員的Token | von3nso2lnfdsfsdnfdsoi23 | ### 返回值 ~~~css { "code": 1, "msg": "新增成功", } ~~~ ## 新增自定義表單數據用于寫入自定義表單數據 ### 請求URL http://www.yoursite.com/addons/cms/api/diyform ### 請求方法 POST ### 請求參數 | Body參數名 | 類型 | 必需 | 描述 | 示例 | | --- | --- | --- | --- | --- | | apikey | string | 是 | API密鑰值,可以從后臺CMS管理站點配置`API密鑰`中獲取 | 無 | | diyform\_id | string | 是 | 自定義表單ID | 1 | | 自定請表單字段1 | string | 是 | 字段1 | 數據1 | | 自定請表單字段n | string | 是 | 字段1 | 數據n | | user\_id | string | 否 | 會員ID,只在自定義表單需要登錄時傳入 | 1 | | token | string | 否 | 會員的Token,只在自定義表單需要登錄時傳入 | von3nso2lnfdsfsdnfdsoi23 | ### 返回值 ~~~css { "code": 1, "msg": "數據提交成功", } ~~~ ## 溫馨提示該API接口僅限用于數據遷移或內部接口，不建議用于對接外部API接口該API接口不支持跨域訪問，如需跨域訪問，需要自行對`addons/cms/controller/Api.php`二次開發，添加跨域的檢測方法。