以明确的身份和公开知识为基础进行开发。

公开、只读资源

公开页面为伺服器端渲染，具有规范语言 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-Hans'

私有集成与写入访问

经过验证的应用端点为第一方工作流程，而非公开的合作伙伴 API。目前不提供公开的开发者钥匙发行、外部购买 API 或自动结算集成。在启用写入访问之前，提议的集成需要组织范围的凭证、最小权限访问、幂等操作、审计追踪及独立协议。

报告技术或安全问题

将受影响的公开 URL、时间戳、预期结果及最小重现步骤发送至 business@hkaiiff.org。对于安全问题，先分享描述并请求私密通道以提供证据。请勿包含存取代码、登入代码、私钥或其他组织的数据。切勿进行破坏性测试或批量收集私密记录。