問題反饋

統一的問題反饋調度中心:任何接入項目放一個鏈接或 iframe 即可接入(零代碼),用戶提交建議 / 升級 / 問題 / BUG 並可帶圖片與視頻,AI 先審內容、管理員後臺回復。

/api/feedback/

服務說明

「問題反饋中心」是一套統一的、所有接入項目共用的反饋調度中心。接入非常簡單——子項目零代碼:只要在頁面上放一個指向 /feedback/<你的 APPID>/ 的鏈接(或把它塞進 iframe)即可,反饋表單、附件上傳、AI 審核、公開區與開發者聯繫方式都由本服務託管,你不需要寫任何提交邏輯,也不需要保存任何反饋數據。

用戶側流程:選擇反饋類型(功能建議 / 功能升級 / 使用問題 / BUG 反饋 / 其他)→ 填寫內容(無需標題)→ 選填圖片與視頻(張數、大小上限由後臺統一配置)→ 提交。遊客可直接匿名提交(需先通過圖形驗證碼,並受同 IP 頻率限制);已登錄用戶提交會帶上用戶身份,登錄後可查看「我的反饋」並繼續追問。提交後狀態為「待審核」,AI 審核通過後進入「待處理」,管理員回復後變為「已回復」。

登錄態怎麼傳給反饋頁:子項目前端用用戶自己的 UAC Token 調 POST /api/feedback/ticket換一張一次性、5 分鐘過期的票據,把票據拼進反饋頁地址(?ticket=xxx)作為鏈接或 iframe 地址;反饋頁消費票據後建立會話,並 303 重定向到不帶票據的乾淨地址。這樣 UAC Token 不會落在 URL、瀏覽器歷史與服務器訪問日誌裡。遊客無需票據,直接打開反饋頁即可。

開發者聯繫方式的查看位置(三處):① 反饋頁底部(/feedback/<app_id>/ 的「開發者聯繫方式」卡片);② 公開區頁面同樣展示同一份聯繫方式;③ 子項目也可以在自己的頁面上調用本服務的 GET /api/feedback/contacts?app_id=<APPID>(免簽名)拿到這份數據,自行渲染。聯繫方式由超管在後臺「問題反饋 → 反饋中心設置 → 各項目開發者聯繫方式」按項目分別維護,展示平臺(QQ / QQ 郵箱 / 微信 / Telegram / WhatsApp / Discord 等)與具體值都可自定義,不同項目可以填不同的值。

AI 審核說明:開關與兩套提示詞都在後臺「反饋中心設置 → AI 審核」裡配置(留空則使用內置通用規則)。規則就是提示詞——後臺寫的規則會與反饋正文、提交者信息一起發給 AI,由 AI 判定是否駁回。提交內容的審核在後臺線程裡逐條慢慢審,不佔用你的接口調用;平臺沒有配置可用 AI 模型時自動跳過審核,提交直接進入「待處理」。管理員回復前 AI 也會審一遍語氣,但只提醒、不阻斷,管理員可以修改後重發,也可以強制發送(強制發送會記入審核留痕)。若某條反饋因故沒審到(例如審核調用失敗),後臺可以直接對它點「立即送審」優先補審。

數據隔離與公開區:反饋數據按接入項目隔離,後臺可按項目 / 狀態 / 類型 / AI 審核狀態篩選與搜索。每個項目還有一個「公開區」——只展示遊客提交且已通過審查的反饋(不展示任何附件與提交者身份),供訪客搜索是否已經有人提過同樣的問題;管理員可隨時把某條從公開區撤下。

反饋中心(託管反饋頁接入)

站內反饋庫(數據按接入項目隔離) 開放 · 免簽名

兩個端點都免簽名(服務策略裡配成 open):ticket 的憑證是調用方本來就持有的用戶 UAC Token,contacts 是公開信息。提交、查看與回復都不走 /api/,而是在 /feedback/<app_id>/ 反饋頁上由本站直接處理。

POST /api/feedback/ticket 累計調用 4 次

換取反饋頁一次性票據

用用戶的 UAC Token 換一張一次性票據(5 分鐘過期),子項目把它拼進反饋頁地址即可讓用戶以登錄身份提交反饋。

用戶在你項目下的 UAC Token(Token 綁定項目,跨項目的 Token 無效)

  • 返回 data.ticket / data.expire_in / data.app_id / data.app_name。
  • 票據一次性且 5 分鐘過期:用完或過期即廢,重複使用會被忽略(反饋頁按遊客處理)。
  • 拼接方式:/feedback/<app_id>/?ticket=<ticket>,作為鏈接或 iframe 地址交瀏覽器打開。
GET /api/feedback/contacts 累計調用 3 次

查詢項目開發者聯繫方式

查詢某個接入項目已啟用的開發者聯繫方式(平臺名 / 值 / 可點擊鏈接),與反饋頁底部展示的是同一份數據。

在後臺「接入項目」裡查到的 APPID

  • 返回 data.contacts 數組,每項含 platform / name / icon / label / value / url;url 為空串表示該平臺未配置跳轉模板,此時按純文本展示。
  • 平臺被停用或該項目的該項被清空後,對應條目不再返回。
小影API · 通用 API 聚合服務