判斷該使用者是否為被踢出使用者
更新時間:2022-05-23 17:54:01
介面URL
http://api.polyv.net/live/v3/channel/chat/is-kicked
介面說明
1、作用:判断该用户是否是被踢出的用户。
2、接口支持https协议
支援格式
JSON
請求方式
POST
請求參數
| 參數名 | 必選 | 類型 | 說明 |
|---|---|---|---|
| roomId | 是 | string | 頻道號/房間號 |
| userId | 是 | string | 使用者userId |
回應成功JSON範例
{
"code": 200,
"data": true,
"message": "",
"status": "success"
}
回應失敗JSON範例:
未輸入appId
{
"code": 400,
"status": "error",
"message": "appId is required.",
"data": ""
}
appId不正確
{
"code": 400,
"status": "error",
"message": "application not found.",
"data": ""
}
時間戳錯誤
{
"code": 400,
"status": "error",
"message": "invalid timestamp.",
"data": ""
}
簽名錯誤
{
"code": 403,
"status": "error",
"message": "invalid signature.",
"data": ""
}
欄位說明
| 參數名 | 說明 |
|---|---|
| code | 回應代碼,成功為200,失敗為400,簽名錯誤為401,異常錯誤500 |
| status | 成功為success,失敗為error |
| message | 錯誤時為錯誤提示訊息 |
| data | true(是被踢出的使用者)/false(不是被踢出的使用者) |
php請求範例
?php
//引用config.php
include 'config.php';
$params = array(
'appId' => $appId,
'timestamp' => $timestamp,
'roomId' => $roomId,
'userId' => $userId
);
//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法
$params['sign'] = $sign;
$url = "http://api.polyv.net/live/v3/channel/chat/is-kicked?".http_build_query($params);
$curl = curl_init();
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 500);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, 0);
$res = curl_exec($curl);
curl_close($curl);
echo $res;
?>
