AI 文件

這一頁是純 AI 專用文檔，適合直接把網址丟給 ChatGPT、Claude、Cursor 或其他 coding agent。

登入開發者中心 查看前台 API 文件

快速分享給 AI

如果你只想給 AI 一段最短指令，直接複製這段即可。
請先閱讀這份 AI 文件：https://ccpass.0800945.com/ai-docs
並依現有專案架構完成串串通登入整合。
請不要把 /oauth/token/ 誤當成 access_token API，它回傳的是 open_id、email、user_id 等會員識別資料。

一鍵複製整份 AI 提示包

這裡已經把快速指令、通用提示詞、Coding Agent 提示詞、JSON 契約與驗收清單整合成一包。
【串串通 Ccpass AI 提示包】

一、快速指令
請先閱讀這份 AI 文件：https://ccpass.0800945.com/ai-docs
並依現有專案架構完成串串通登入整合。
請不要把 /oauth/token/ 誤當成 access_token API，它回傳的是 open_id、email、user_id 等會員識別資料。

二、通用提示詞
你現在要協助我把「串串通 Ccpass」登入整合到我的網站。

請先完整閱讀這份文件：
https://ccpass.0800945.com/ai-docs

系統端點：
- 授權端點：https://ccpass.0800945.com/oauth/authorize/
- Token 交換端點：https://ccpass.0800945.com/oauth/token/
- Email 發碼端點：https://ccpass.0800945.com/api/send-code/
- Email 驗證端點：https://ccpass.0800945.com/api/verify-code/

整合規則：
- 先導向 `/oauth/authorize/`
- callback 會回到 `redirect_uri` 並帶回 `code`、`state`
- 後端再用 `client_id`、`client_secret`、`code` 呼叫 `/oauth/token/`
- `/oauth/token/` 成功時回傳的是 `open_id`、`email`、`user_id`、`client_id`
- 這不是標準 Bearer access token 流程

請務必遵守：
- `client_secret` 只能在後端使用
- `state` 必須產生、保存、比對
- `redirect_uri` 必須與 App 設定完全一致
- 以 `provider=ccpass + open_id` 建立或查詢綁定資料
- 若 email 已存在但尚未綁定，請設計安全的合併或綁定流程

請直接提供：
- 路由設計
- Controller
- Service
- Model / 資料表
- Session / 登入狀態寫入方式
- 錯誤處理
- 驗收步驟

三、Coding Agent 提示詞
你現在是一名 coding agent，請根據這份文件直接在現有專案內完成登入整合：
https://ccpass.0800945.com/ai-docs

工作要求：
1. 先閱讀專案現有會員登入、Session、路由與資料表結構
2. 新增登入入口與 callback 路由
3. 新增後端 Token 交換 service
4. 新增或沿用第三方綁定表，至少保存 `provider`、`open_id`、`member_id`、`email`
5. 完成登入成功後的 Session 寫入與導頁
6. 補上 state 驗證、錯誤處理與必要註解

重要規則：
- `/oauth/token/` 回傳的是會員識別資料，不是 access token
- `client_secret` 不能出現在前端
- `redirect_uri` 必須與 App 設定完全一致
- `state` 必須保存並驗證

請交付：
- 實際修改了哪些檔案
- 新增了哪些資料表或欄位
- 如何設定 `client_id`、`client_secret`、`redirect_uri`
- 如何驗證整合成功

四、JSON 契約
{
    "platform": {
        "name": "串串通 Ccpass",
        "docs_url": "https://ccpass.0800945.com/ai-docs",
        "base_url": "https://ccpass.0800945.com"
    },
    "oauth": {
        "authorize": {
            "method": "GET",
            "url": "https://ccpass.0800945.com/oauth/authorize/",
            "query": [
                "client_id",
                "redirect_uri",
                "state"
            ]
        },
        "callback": {
            "returns_query": [
                "code",
                "state"
            ]
        },
        "token_exchange": {
            "method": "POST",
            "url": "https://ccpass.0800945.com/oauth/token/",
            "content_type": "application/json",
            "body": [
                "client_id",
                "client_secret",
                "code"
            ],
            "response": [
                "success",
                "data.open_id",
                "data.email",
                "data.user_id",
                "data.client_id"
            ],
            "note": "回傳會員識別資料，不是 access_token"
        }
    },
    "email_verification": {
        "send_code": {
            "method": "POST",
            "url": "https://ccpass.0800945.com/api/send-code/",
            "body": [
                "email",
                "purpose"
            ]
        },
        "verify_code": {
            "method": "POST",
            "url": "https://ccpass.0800945.com/api/verify-code/",
            "body": [
                "email",
                "code",
                "purpose"
            ]
        }
    },
    "binding": {
        "provider": "ccpass",
        "unique_key": [
            "provider",
            "open_id"
        ],
        "recommended_columns": [
            "member_id",
            "provider",
            "open_id",
            "email"
        ]
    }
}

五、驗收清單
- 能正確導向 /oauth/authorize/。
- callback 能收到 code 與 state，且會驗證 state。
- 後端能成功呼叫 /oauth/token/ 並解析 open_id、email、user_id。
- 能查詢或建立第三方綁定資料。
- 登入成功後能寫入本站 Session 並導向登入成功頁。
- 若需要 Email 驗證，也能正確使用 /api/send-code/ 與 /api/verify-code/。

核心規格

AI 文件網址 https://ccpass.0800945.com/ai-docs
授權端點 https://ccpass.0800945.com/oauth/authorize/
Token 交換端點 https://ccpass.0800945.com/oauth/token/
Email 發碼端點 https://ccpass.0800945.com/api/send-code/
Email 驗證端點 https://ccpass.0800945.com/api/verify-code/
範例 Client ID 請先在開發者中心建立 App 取得 client_id
範例 Callback URL https://your-domain.com/oauth/callback

AI 一定要理解的規則

  • 流程固定是：登入入口 -> /oauth/authorize/ -> callback 收 code/state -> 後端 /oauth/token/。
  • /oauth/token/ 回傳的是會員識別資料，不是標準 access_token。
  • client_secret 只能在後端保存與呼叫。
  • redirect_uri 必須與 App 設定完全一致。
  • state 必須產生、保存、比對。
  • 建議以 provider=ccpass + open_id 建立綁定資料。
可直接貼給 ChatGPT / Claude 的提示詞
你現在要協助我把「串串通 Ccpass」登入整合到我的網站。

請先完整閱讀這份文件：
https://ccpass.0800945.com/ai-docs

系統端點：
- 授權端點：https://ccpass.0800945.com/oauth/authorize/
- Token 交換端點：https://ccpass.0800945.com/oauth/token/
- Email 發碼端點：https://ccpass.0800945.com/api/send-code/
- Email 驗證端點：https://ccpass.0800945.com/api/verify-code/

整合規則：
- 先導向 `/oauth/authorize/`
- callback 會回到 `redirect_uri` 並帶回 `code`、`state`
- 後端再用 `client_id`、`client_secret`、`code` 呼叫 `/oauth/token/`
- `/oauth/token/` 成功時回傳的是 `open_id`、`email`、`user_id`、`client_id`
- 這不是標準 Bearer access token 流程

請務必遵守：
- `client_secret` 只能在後端使用
- `state` 必須產生、保存、比對
- `redirect_uri` 必須與 App 設定完全一致
- 以 `provider=ccpass + open_id` 建立或查詢綁定資料
- 若 email 已存在但尚未綁定，請設計安全的合併或綁定流程

請直接提供：
- 路由設計
- Controller
- Service
- Model / 資料表
- Session / 登入狀態寫入方式
- 錯誤處理
- 驗收步驟
可直接貼給 Coding Agent 的提示詞
你現在是一名 coding agent，請根據這份文件直接在現有專案內完成登入整合：
https://ccpass.0800945.com/ai-docs

工作要求：
1. 先閱讀專案現有會員登入、Session、路由與資料表結構
2. 新增登入入口與 callback 路由
3. 新增後端 Token 交換 service
4. 新增或沿用第三方綁定表，至少保存 `provider`、`open_id`、`member_id`、`email`
5. 完成登入成功後的 Session 寫入與導頁
6. 補上 state 驗證、錯誤處理與必要註解

重要規則：
- `/oauth/token/` 回傳的是會員識別資料，不是 access token
- `client_secret` 不能出現在前端
- `redirect_uri` 必須與 App 設定完全一致
- `state` 必須保存並驗證

請交付：
- 實際修改了哪些檔案
- 新增了哪些資料表或欄位
- 如何設定 `client_id`、`client_secret`、`redirect_uri`
- 如何驗證整合成功
可直接給 AI / Agent 讀的 JSON 契約
{
    "platform": {
        "name": "串串通 Ccpass",
        "docs_url": "https://ccpass.0800945.com/ai-docs",
        "base_url": "https://ccpass.0800945.com"
    },
    "oauth": {
        "authorize": {
            "method": "GET",
            "url": "https://ccpass.0800945.com/oauth/authorize/",
            "query": [
                "client_id",
                "redirect_uri",
                "state"
            ]
        },
        "callback": {
            "returns_query": [
                "code",
                "state"
            ]
        },
        "token_exchange": {
            "method": "POST",
            "url": "https://ccpass.0800945.com/oauth/token/",
            "content_type": "application/json",
            "body": [
                "client_id",
                "client_secret",
                "code"
            ],
            "response": [
                "success",
                "data.open_id",
                "data.email",
                "data.user_id",
                "data.client_id"
            ],
            "note": "回傳會員識別資料，不是 access_token"
        }
    },
    "email_verification": {
        "send_code": {
            "method": "POST",
            "url": "https://ccpass.0800945.com/api/send-code/",
            "body": [
                "email",
                "purpose"
            ]
        },
        "verify_code": {
            "method": "POST",
            "url": "https://ccpass.0800945.com/api/verify-code/",
            "body": [
                "email",
                "code",
                "purpose"
            ]
        }
    },
    "binding": {
        "provider": "ccpass",
        "unique_key": [
            "provider",
            "open_id"
        ],
        "recommended_columns": [
            "member_id",
            "provider",
            "open_id",
            "email"
        ]
    }
}

驗收清單

  • 能正確導向 /oauth/authorize/。
  • callback 能收到 code 與 state，且會驗證 state。
  • 後端能成功呼叫 /oauth/token/ 並解析 open_id、email、user_id。
  • 能查詢或建立第三方綁定資料。
  • 登入成功後能寫入本站 Session 並導向登入成功頁。
  • 若需要 Email 驗證，也能正確使用 /api/send-code/ 與 /api/verify-code/。

使用建議

最短可給 AI 的網址
https://ccpass.0800945.com/ai-docs
Callback 測試頁
/developer/index.php?route=callback-tester
最重要提醒
`/oauth/token/` 回傳的是會員識別資料，不是 Bearer `access_token`。
建議搭配
  • 要完整背景時，先看 `API 文件`
  • 要測 callback 時，使用 `Callback 測試頁`
  • 要直接給 AI 做事時，就丟這一頁