Partner OAuth 接入
Beta。 OAuth 模式正在灰度開放,請聯絡我們登記你的應用。
如果你已經把 ofox 整合進自己的產品,使用者可以透過一個 OAuth 按鈕完成授權,全程不離開你的應用。透過這種方式註冊的新使用者會自動計入你的 partner 渠道 —— 與他們透過你的推廣連結註冊完全等效。
如何接入
- 聯絡我們登記你的應用。
- 我們為你建立 OAuth 應用,並綁定到你的推廣渠道。
- 在你的產品裡按標準 OAuth 2.1 流程接入授權按鈕。
除標準 OAuth 流程外,你這邊不需要任何額外設定 —— 沒有額外參數、沒有 URL 格式約定、沒有 SDK。渠道映射由我們在伺服器端設定。
哪些消耗會被計入
僅限新註冊使用者。 當一個還沒有 ofox 帳號的使用者點擊你的 OAuth 按鈕,他會被帶到 ofox 登入頁,切換到註冊流程並完成註冊 —— 綁定在註冊那一刻建立。此後他的儲值與消費都走正常的 partner 返佣結算。
已有 ofox 帳號的使用者,其歸屬永不改變。 授權你的應用不會改變它 —— 即使該使用者從未被任何 partner 綁定過也一樣。這既適用於已綁定其他 partner 的使用者,也適用於完全沒有綁定的使用者。
這是刻意設計:推廣綁定對一個帳號是終身且排他的。允許改綁等於讓一個 partner 搶走另一個 partner 拉來的使用者。
首次呼叫的 scope
剛註冊完拿到的 access token,可能還不包含 llm.invoke。
llm.invoke 只發給電子郵件已驗證的使用者。而註冊完成那一刻郵件是否已驗證,取決於使用者選了哪種註冊方式:
| 註冊方式 | 完成時郵件是否已驗證 | 首個 token 裡有無 llm.invoke |
|---|---|---|
| 免密登入連結 | 是 —— 點開連結本身就是驗證 | 有 |
| 電子郵件 + 密碼 | 否 | 被剔除,直到驗證完成 |
scope 被剔除時 token 請求仍會成功 —— 回應裡的 scope 欄位列出的是實際發放的集合(RFC 6749 §3.3)。請讀這個欄位,不要假設申請什麼就拿到什麼。 沒有 llm.invoke 去呼叫 LLM API 會回傳 403 insufficient_scope。
使用者完成郵件驗證後,重新取得(或刷新)token,llm.invoke 就會包含在內。
返佣
被歸因的使用者按標準分層返佣結算(最高 9%),依據實際 API 用量計算。滿 $50 起提,按月結算。當前條款見 Partner 頁面 。