回調舉報資訊通知
更新時間:2023-02-13 11:33:08
作用
使用本功能,使用者發起回饋/舉報後,伺服端會對客戶所設定的介面位址,以 POST 方式提交到給使用者自訂的回調介面進行通知。
超時重試
1、回調伺服器在發送訊息通知後,5秒內沒有收到您的伺服器的回應,即認為通知失敗。後續失敗會以5秒間隔繼續重試2次。 2、介面回傳 JSON 物件,如果回調沒有回傳 200,會重試 2 次,超過 2 次則丟棄日誌。
回調訊息格式
事件回調訊息以 HTTP/HTTPS POST 請求發送給您的伺服器,其中:
- 字元編碼格式:UTF-8。
- 請求:body 格式為 JSON。
- 應答要求:回應頭需指定 Content-Type: application/json;
- 正確應答:http status code: 200 為正確業務接收處理,其他狀態一律視為失敗重試處理。
回調參數說明
| 參數名 | 類型及範圍 | 說明 |
|---|---|---|
| userId | string | 直播帳號 ID |
| channelId | string | 頻道號 |
| channelName | string | 頻道名稱 |
| viewerId | string | 觀眾 ID |
| viewerName | string | 觀眾暱稱 |
| createdTime | string | 發起時間(格式:yyyyMMddHHmmss) |
| type | string | 類型 complaint:舉報 suggestion:回饋 |
| label | string | 舉報分類 porn:色情低俗 bloody:恐怖血腥 scam:詐騙資訊 uncivilized:發言不雅 illegal-entry:成員亂入 infringe-right:侵犯權益 other-violations:其他舉報 回饋分類 stuck:頁面卡頓 black-screen:畫面黑屏 slow-access:存取緩慢 poor-experience:體驗不佳 play-suggestion:玩法建議 other-feedback:其他回饋 |
| content | string | 內容 |
| imageUrls | array | 圖片 URL |
| contact | string | 聯絡方式 |
| actor | string | 主講頭銜 |
| teacherName | string | 主講暱稱 |
回調資料範例
回應體:
{
"userId": "43231hnaa2",
"channelId": 2191532,
"channelName": "测试",
"viewerId": "1676254629615",
"createdTime": "20230213112103",
"type": "suggestion",
"label": "stuck",
"content": "123123",
"imageUrls": ["http://liveimages.videocc.net/watch-feedback/43f5f9caa2/3757791/1676258463568_37rXln.jpeg"],
"contact": "",
"actor": "讲师",
"teacherName": "讲师"
}
如何設定
透過後台設定:
登入帳戶 - 進入【雲直播】 - 點選【開發設定】- 點選【回調設定】- 直播間一鍵舉報資訊回調
注意:提交的介面位址必須要以 http:// 或者 https:// 開頭
