跳到內容

用 AI 助手串接

在 ChatGPT 開啟在 Claude 開啟

AI 助手寫金流串接程式很快,但它記得的常常是舊版規則。最可靠的做法,是把本站的最新內容直接交給它。

檔案 內容 適合
/llms.txt 全站頁面索引與摘要 讓 AI 知道有哪些頁面,再自己去讀
/llms-full.txt 全站內容的純文字版 一次交給 AI 完整內容
/openapi/payment-api.json Payment API 的 OpenAPI 3.1 定義 產生 client 程式、匯入 Postman

使用方式:

  • 只需要一頁時:每一頁標題下方都有「複製成 Markdown(給 AI 用)」,以及「在 ChatGPT 開啟」「在 Claude 開啟」。
  • Claude、ChatGPT 等對話介面:把 https://developer.oen.tw/llms-full.txt 的網址或內容貼進對話,再說明你要做什麼。
  • Cursor、Claude Code 等開發工具:把 llms-full.txt 下載到專案,或在工具的文件設定加入本站網址。
  • Postman:選 Import,貼上 https://developer.oen.tw/openapi/payment-api.json。
請依照 https://developer.oen.tw/llms-full.txt 的應援 Payment API 文件,
用 Node.js(Express)寫:
1. 建立單次付款結帳頁的 API(金額與品項由我的訂單資料計算)
2. 接收付款通知的 endpoint:收到後用 GET /transactions/{id} 回查狀態再更新訂單
3. token 從環境變數 OEN_API_TOKEN 讀取,先打測試環境

拿到程式後,請對照上線檢查清單逐項確認,特別是:

  • productDetails 的品項合計要等於 amount。
  • 付款通知沒有簽章,一定要回查。
  • 付款結果不確定(HTTP 409)時,不要直接重新扣款。