AI 協助對接
您可以把本文件交給 AI 編程工具（例如 Claude、ChatGPT、Cursor、GitHub Copilot），讓它協助產生串接程式碼。本頁提供可直接給 AI 讀取的文件檔案。
下載文件檔案
本文件只能從白名單 IP 開啟，AI 工具無法直接讀取網址，請先下載檔案再交給 AI。
| 檔案 | 內容 | 適用情況 |
|---|---|---|
| llms-full.txt | 全部頁面合併成一個 Markdown 檔案 | 大多數情況請用這個，一次給 AI 完整規則 |
| llms.txt | 文件目錄與各頁摘要 | AI 工具的內容長度有限，只想給目錄時 |
每一頁也有對應的 Markdown 版本，把網址的 .html 換成 .md 即可取得，例如代收建單的 Markdown 版本在 /api/collect.md。
文件更新後請重新下載，以免 AI 依舊版規則產生程式碼。
交給 AI 的方式
| 工具類型 | 做法 |
|---|---|
| 對話介面（Claude、ChatGPT 等） | 把 llms-full.txt 作為附件上傳，再說明要它做什麼。 |
| 編程工具（Claude Code、Cursor、GitHub Copilot 等） | 把 llms-full.txt 放進您的專案，例如 docs/qpay-api.md，在對話中引用這個檔案（例如 @docs/qpay-api.md）。之後每次要 AI 修改串接程式時都可以重複引用。 |
不要把機密資料交給 AI
- 不要把正式環境的 API 驗證金鑰貼進對話或上傳給 AI。請讓 AI 從環境變數或設定檔讀取金鑰，測試時使用簽章範例的範例憑證或測試環境憑證。
- 不要把真實訂單、付款人姓名、收款帳號等資料貼給 AI。
驗證 AI 產生的程式
AI 可能誤解規則或自行假設，請不要直接把產生的程式碼用在正式環境：