API 列表 - D7CMS

API 端點列表

D7CMS 系統中所有可用的 API 端點及其使用說明，供開發者參考使用

✓

API 修復更新 (2025-08-22)

• 頁面管理 API - 修復了 500 錯誤問題，現在可正常創建和編輯頁面

• 內容格式處理 - 加入智能雙重序列化修復，自動處理格式轉換

• 向後相容性 - 完全支援舊版本內容格式，無需手動遷移

網域管理 API

管理網域資訊、狀態和聯絡資料

系統管理
GET /api/domains

獲取所有網域列表

響應: 網域列表陣列，包含 ID、名稱、狀態、聯絡資訊等
POST /api/domains

創建新網域

請求體: name, domain_url, status, contact_email, contact_phone

文章管理 API

管理文章內容、狀態和 SEO 資訊

內容管理
GET /api/articles?domain_id={id}

獲取指定網域的文章列表

參數: domain_id, page, limit, search, status
POST /api/articles

創建新文章

請求體: title, content, domain_id, status, seo_title, seo_description
PUT /api/articles/{id}

更新文章

請求體: 可更新的文章欄位

頁面管理 API

管理靜態頁面內容和佈局，支援視覺化內容編輯

內容管理
GET /api/pages?domain_id={id}

獲取指定網域的頁面列表

參數: domain_id, status, page_type, search, limit, offset
✅ 已修復 - 支援內容格式自動轉換
GET /api/pages/{id}

獲取單一頁面詳細資訊

響應: 頁面完整資訊，包含處理後的 content_json
✅ 已修復 - 自動修復雙重序列化問題
POST /api/pages

創建新頁面

請求體: domain_id, title, slug, content_json, page_type, status, seo_title, meta_description
✅ 已修復 - 支援簡化內容格式和區段格式
PUT /api/pages/{id}

更新頁面資訊和內容

請求體: 可更新的頁面欄位（支援部分更新）
✅ 已修復 - 智能內容格式處理
DELETE /api/pages/{id}

刪除指定頁面

安全: 需要確認刪除操作

📝 內容格式支援

簡化格式: 支援 hero、features、testimonials 等預設區段

自動轉換: 舊版 sections 格式自動轉換為新格式

錯誤修復: 自動檢測和修復雙重序列化問題

向後相容: 完全相容舊版本儲存的內容

佈局管理 API

管理頁面佈局和組件配置

內容管理
GET /api/layouts

獲取佈局列表

參數: type, global, published, page, limit, search
POST /api/layouts

創建新佈局

請求體: name, content_json, status, type

遊戲管理 API

管理遊戲資訊和分類

內容管理
GET /api/games?domain_id={id}

獲取指定網域的遊戲列表

參數: domain_id, page, limit, search, status, genre
POST /api/games

創建新遊戲

請求體: title, description, genre, domain_id, status

品牌管理 API

管理網站品牌資訊、App 連結和聯盟廠商連結

內容管理
GET /api/brands?domain_id={id}

獲取指定網域的品牌資訊

參數: domain_id
響應: 包含品牌資訊、App 連結和聯盟連結的完整資料
POST /api/brands

建立或更新品牌資訊

參數: domain_id, logo_url, social_links, address, contact_email, contact_phone, app_title, app_description, app_url, affiliate_title, affiliate_description, affiliate_url

區塊管理 API

管理可重複使用的內容區塊

內容管理
GET /api/sections

獲取區塊列表

功能: 管理可重複使用的內容區塊

檔案儲存 API

管理 R2 雲端儲存和圖片上傳

檔案儲存
GET /api/r2-list

列出 R2 儲存桶中的檔案

POST /api/r2-upload

上傳檔案到 R2 儲存

GET /api/r2-list-images

列出 R2 中的圖片檔案

系統工具 API

系統維護和除錯工具

系統管理
GET /api/status

檢查系統狀態

POST /api/init-db

初始化資料庫

POST /api/reset-db

重置資料庫

📚 API 使用說明

認證: 所有 API 端點都需要適當的認證和權限

響應格式: 統一使用 JSON 格式，包含 success、data、message 等欄位

錯誤處理: 錯誤響應會包含 error 欄位說明錯誤原因

分頁: 支援分頁的 API 會返回 pagination 物件

查詢參數: 大部分 API 支援 search、status、page、limit 等通用參數