ApiKey使用說明

ApiKey用于通過開放接口訪問問卷星服務。使用ApiKey調用接口時，無需再計算sign簽名，只需要在請求頭中攜帶Authorization即可完成鑒權。

一、創建ApiKey

進入「用戶信息」頁面，在「ApiKey」一行點擊「管理ApiKey」。

點擊「生成ApiKey」創建密鑰。

每個賬號最多可創建3個ApiKey。

新生成的ApiKey默認有效期為1年，可在管理窗口中修改有效期。

二、AI工具接入說明

如需在 MCP Server、CLI、SDK 或 AI 工具中調用問卷星開放接口，請查看
AI 工具接入說明。
ApiKey 可作為接口調用的鑒權憑證使用。

三、調用方式

調用開放接口時，在HTTP請求頭中加入以下內容：

Authorization: Bearer 您的ApiKey

接口仍需要傳入action以及對應接口要求的業務參數。使用ApiKey鑒權時，appid、ts、sign不再作為必填鑒權參數。

curl -X POST "http://www.kaben.cc/openapi/default.aspx?action=1001002" \
  -H "Authorization: Bearer sk-wjx-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d "{\"activity\":\"問卷ID\"}"

四、權限與頻率限制

ApiKey沿用開放接口權限配置。首次生成ApiKey時，系統會默認開啟常用問卷和答卷相關接口權限。

如需調整接口范圍或QPS限制，請聯系客戶顧問或由管理員在開放接口權限中配置。

如果接口返回「權限不足」或「查詢頻率過快」，請檢查當前賬號是否已開通對應接口權限，以及請求頻率是否超過該接口的QPS限制。

五、安全設置

請妥善保管ApiKey，不要寫入前端頁面、公開代碼倉庫或可被第三方訪問的日志中。

建議為不同系統或不同調用方分別創建ApiKey，便于獨立停用和排查問題。

可為每個ApiKey設置有效期，到期后該ApiKey將不能繼續調用接口。

可配置IP白名單或IP黑名單，限制允許調用開放接口的服務器IP。

如懷疑ApiKey泄露，請立即刪除原ApiKey并重新生成。

六、常見錯誤

提示	處理方式
缺少Authorization Bearer Token	檢查請求頭是否按Authorization: Bearer ApiKey格式傳入。
ApiKey無效或已過期	確認ApiKey是否被刪除、是否填寫完整，或是否超過有效期。
當前IP不在白名單中	將服務器出口IP加入該ApiKey的IP白名單，或關閉白名單限制。
權限不足	檢查賬號是否擁有對應action權限。
查詢頻率過快	降低請求頻率，或確認當前接口QPS配置是否滿足調用需求。