以明確的身份和公開知識為基礎進行開發。

公開、只讀資源

公開頁面為伺服器端渲染，具有規範語言 URL，並在適當位置包含結構化數據。以下知識源包含與本網站相同的公開指南及回答。不包含帳户、私密訊息、交付檔案及交易數據。

• GET /knowledge.json — 帶有規範 URL、語言和更新日期的版本化公開頁面與問題記錄。
• GET /llms.txt — 官方市場資源的簡目錄。
• GET /sitemap.xml — 以支援語言發布的公開頁面及電影 URL。
• 項目頁面 — 公開 INDEX 標識符、源連結及可用的項目資訊。

知識源合約

使用 schemaVersion 欄位偵測格式變更。每個頁面都有穩定路徑、url、標題、描述、章節及問題。每個問題包含 id、問題、回答及可選的下一步連結。lang 查詢接受支援的語言區域，例如 /knowledge.json?lang=zh-Hant。不支援的語言值會返回 HTTP 400。請使用 ETag 標頭進行條件請求；未變動的資源會返回 HTTP 304。

在呈現回答時，請引用規範頁面 URL、語言和更新日期。保留有關權利、服務可用性和源數據聲明的限定條件。公開訪問元數據並不授予重複使用電影、海報或其他創意資產的許可。

curl -i 'https://hkaiiff.market/knowledge.json?lang=zh-Hant'

私有集成與寫入訪問

經過驗證的應用端點為第一方工作流程，而非公開的合作夥伴 API。目前不提供公開的開發者鑰匙發行、外部購買 API 或自動結算集成。在啟用寫入訪問之前，提議的集成需要組織範圍的憑證、最小權限訪問、冪等操作、審計追蹤及獨立協議。

報告技術或安全問題

將受影響的公開 URL、時間戳、預期結果及最小重現步驟發送至 business@hkaiiff.org。對於安全問題，先分享描述並請求私密通道以提供證據。請勿包含存取代碼、登入代碼、私鑰或其他組織的數據。切勿進行破壞性測試或批量收集私密記錄。