代理轉售/串接檢查清單

代理轉售串接檢查清單

如果你將 Wokey API 轉售給自己的下游使用者,請依序檢查下面的清單。每一項都連結到詳細說明。

串接清單link

  1. 1

    每個請求都帶上 X-End-User-Id

    一把金鑰服務許多終端使用者時,這個標頭用來標明請求屬於哪位終端使用者。若某位終端使用者反覆違規,Wokey 只會限制該使用者,你的其他使用者照常使用。企業帳號與轉售帳號也可以在控制台查看受限使用者並解除限制。

    終端使用者識別與限制 →

  2. 2

    偵測模型拒答

    模型拒答時仍會回傳 HTTP 200,因此需要從回應中的欄位判斷。偵測到拒答後,請提示你的使用者修改內容,而不是原樣重試同一個請求。

    模型拒答 →

  3. 3

    及早攔下違規使用者

    反覆觸發拒答會導致限流、模型停用與違規處置費。無論是否帶上 X-End-User-Id,違規都會計入你的帳號,所以請在把請求送到 Wokey 之前先過濾內容。

    違規處置費與限制 →

  4. 4

    依狀態碼處理錯誤

    區分餘額不足(402)、限流(429)與上游錯誤(502、504、529),並分別提示使用者或重試。聯絡客服時請附上回應標頭 x-wokey-request-id。

    錯誤碼 →

  5. 5

    監控餘額與用量

    用 /v1/dashboard/balance 查詢帳號餘額,用 /v1/usage 和 /v1/key 查詢每把金鑰的用量與剩餘額度。請在餘額用完前儲值。

    餘額與用量 →

  6. 6

    需要時指定供應商

    同一個模型有多家供應商時,可以在請求內容中用 provider 指定或排除供應商。

    指定供應商 →