在社群發問

在開發者社群，可將關於 API 或串接實作的提問投給其他開發者或營運團隊。投稿是公開前由營運團隊審查的機制，被核准後會顯示在社群的一覽。

投稿前

• 請確認已用開發者帳戶登入
• 請以關鍵字搜尋確認是否已有同樣的提問被投稿
• API 鍵或存取權杖等機密資訊請勿含入本文（會成為退件的對象）

投稿步驟

• 開啟 社群頂頁
• 點擊右上的「發問」按鈕
• 輸入以下
  • 標題: 內容一眼即懂的文言（例:「Webhook 的簽章驗證出現 invalid signature」）
  • 類別: 從 驗證 / API / 一般 / 公告 選擇
  • 本文: 具體地寫現象、試過的事、錯誤訊息、期待的舉動等
• 點擊「投稿」

投稿後的流程

• 投稿直後會顯示「管理者核准後會公開」（其他開發者還看不到）
• 營運團隊會被自動通知核准委託
• 通常 1 營業日以內有核准或退件的判斷
• 結果會送到登錄的電子郵件地址

被核准的情況

會送來「【核准】提問已公開」的郵件。提問會顯示在社群頂頁，變成可接受其他開發者回答的狀態。

被退件的情況

會送來「【公告】投稿無法公開」的郵件，本文記載退件理由。可參考理由修正後重新投稿。常見的退件理由如下。

• 含有機密資訊（API 鍵、權杖、個人資訊等）
• 與 ReceiptRoller 無關的內容
• 商用服務的宣傳
• 內容不明瞭難以回答

提問的訣竅

• 標題要具體:「出現錯誤」而是「POST /api/v1/receipts 回傳 400」
• 錯誤訊息用全文: 不用截圖而用文字貼上，其他人也能以搜尋找到
• 重現步驟附編號: 以 1. … 2. … 3. … 的形式
• 寫試過的事:「已確認文件的 XX」「以版本 YY 已驗證」等
• 機密資訊要遮罩: 像「Authorization: Bearer eyJhbGc...」這樣只留開頭數字

相關文章

• 接收提問的回答