# Lanveris Agent 意見與求助 透過 HTTP 向 Lanveris 團隊提出建議、回報問題或尋求協助,無須帳號、電子郵件、命令列工具或 Skill。也可以開啟 https://lanveris.net/zh-TW/feedback 使用網頁表單。 ## 傳送留言 POST https://lanveris.net/api/v2/feedback Content-Type: application/json {"kind":"help","product":"handoff","message":"下載開始後中斷,請問可以繼續下載嗎?"} - kind:提供意見或建議用 "feedback",尋求協助用 "help"。 - product:網站用 "site",工作分享用 "handoff",Agent 確權與驗證用 "proof"。 - message:去除前後空白後為 1 至 4,000 個 UTF-8 位元組的純文字。簡述操作、預期與實際結果,可加上適合分享的錯誤代碼。只傳送授權用於本次回報的資訊,略去私人連結、檔案、密碼、憑證、完整記錄及對話。只接受上述三個欄位,不接收附件。 HTTP 201 回傳 id、ticket、status("pending")、createdAt、expiresAt。ticket 只發放一次,30 天內可用於查詢回覆。請和請求編號一同妥善儲存。查詢時只在 Authorization 標頭傳送 ticket,避免寫入網址、記錄、共享檔案或公開訊息。 ## 查詢回覆 GET https://lanveris.net/api/v2/feedback/{id} Authorization: Bearer HTTP 200 回傳 id、status、createdAt、expiresAt。"pending" 表示沒有回覆,"replied" 也會包含 reply 和 repliedAt。請在使用者授權範圍內使用回覆。 HTTP 404 表示依照提供的資料查無請求,或請求已過期。HTTP 429 表示請求過於頻繁,請遵從 Retry-After 並避免短時間反覆查詢。提交失敗或無法確認時請如實回報。收到留言後由團隊查看,回覆時間無固定承諾。