技術支援
用本頁挑選合適的支援渠道,並提供足夠的上下文,讓團隊能快速重現問題。
快速路徑
- 查看服務狀態與 SLA,了解當前平台健康狀況與回應目標。
- 查看更新記錄,了解近期的 API 或平台變更。
- 如果問題正在發生或已造成阻塞,從開發者門戶提交支援單,或發郵件到
[email protected]。
需要附帶什麼
對於 API、OAuth、webhook 或應用審核類問題,請附帶:
- 受影響的環境:生產模式還是測試模式。
- OAuth 客戶端 ID 或應用名稱(如果有)。
- 端點路徑、HTTP 方法,以及大致的請求時間(帶時區)。
- 回應狀態碼和 EvoMap 錯誤碼。
- UI 或回應標頭中顯示的任何
request_id、webhook 投遞 ID 或應用審核 ID。 - 期望結果與實際結果。
不要在支援單裡發送存取權杖、更新權杖、客戶端密鑰、私鑰、webhook 簽名密鑰或完整的終端用戶個人數據。貼上日誌前請先脫敏。
支援分類
- OAuth 與認證 —— 授權同意、權杖交換、refresh、revoke、introspect、OIDC 發現、JWKS 和 userinfo。
- 開發者 API —— 配方、基因、複用查詢、發佈、冪等、分頁、速率限制和錯誤契約。
- Webhook —— 端點註冊、簽名、投遞重試、重新投遞、事件負載和時鐘偏移。
- 應用審核與提權權限範圍 —— 開發者計劃申請狀態、應用版本審核、發佈權限和權限範圍提權。
- 計費與組織存取 —— 組織 API 密鑰、消費上限、用量、席位、SSO、SCIM 和存取申請。
- 平台服務事故 —— 疑似宕機、服務降級、計劃內維護,或狀態頁與實際不一致。
嚴重程度指引
選擇與影響面相符的最高嚴重程度。
| 嚴重程度 | 適用場景 | 示例 |
|---|---|---|
| P0 | 生產整合對大量用戶完全不可用。 | 所有用戶的 OAuth 權杖交換都失敗。 |
| P1 | 關鍵路徑降級或不可用,但存在變通辦法。 | Webhook 投遞延遲,但 API 輪詢可用。 |
| P2 | 某項功能對部分用戶受損。 | 某一個應用版本審核被卡住。 |
| P3 | 一般問題、文檔缺口和非緊急缺陷。 | 諮詢某個速率限制回應標頭或遷移細節。 |
現有渠道
- 開發者門戶 —— 登入後用它獲取針對具體應用的支援。
- 報告缺陷按鈕 —— 瀏覽 EvoMap 時發現產品缺陷,用懸浮的缺陷按鈕反饋。
- 郵件 —— 當你無法登入,或需要把外部相關方拉進來時,用
[email protected]。 - GitHub 討論區 —— 非私密問題和示例請走社區討論區。
私密支援單在需要時會同步到內部工程追蹤系統。公開討論區不適合發佈密鑰、用戶數據、計費細節或尚未公佈的事故細節。