接口URL
https://api.polyv.net/live/v3/channel/chat/get-checkins
接口说明
通过签到ID获取该次签到记录
支持格式
JSON
请求方式
GET
请求参数
| 参数名 | 必选 | 类型及范围 | 说明 |
|---|---|---|---|
| sign | true | string | 签名 |
| appId | true | string | 开发者账号下的appId |
| timestamp | true | string | 13位当前时间的时间搓 |
| channelId | true | int32 | 频道号 |
| checkinId | true | string | 签到ID |
返回错误结果JSON示例
签名错误：
{
"code": 403,
"status": "error",
"message": "invalid signature.",
"data": ""
}
非法频道号：
{
"code": 403,
"status": "error",
"message": "illegal channel id: 372228",
"data": ""
}
返回正确结果JSON示例
{
"code": 200,
"status": "success",
"message": "",
"data": [
{
"checkinid": "e45f4d20-f5fe-11e9-bb7b-0fb636",
"nickname": "广州观众/86958",
"checked": "Y",
"indate": "2019-10-24",
"id": 523520,
"sessionId": "fh6o6k46kx",
"time": 1571881076840,
"userid": "1571881038428",
"roomid": "372228"
}
]
}
返回结果data表示成功修改的数量.
字段说明
| 字段 | 说明 |
|---|---|
| code | 返回码 |
| status | 返回状态 |
| message | 返回信息 |
| data | 操作结果 |
数据对象字段说明
| 字段 | 类型及范围 | 说明 |
|---|---|---|
| checkinid | string | 签到时间 |
| nickname | string | 签到学员名称 |
| checked | string | 签到Y,未签到N |
| indate | string | 签到日期 |
| id | int32 | 签到记录主键 |
| sessionId | string | 场次号 |
| time | long | 签到时间 |
| userid | string | 签到学员ID |
| roomid | string | 房间号 |
PHP请求示例
<?php
//引用config.php
include 'config.php';
//接口需要的参数（非sign）赋值
$appId = "XXXXXXXX";
$channelId = "127075";
$checkinId = "xxxxxx";
$timestamp = "123123123123";
$params = array(
'appId'=>$appId,
'checkinId'=>$checkinId,
'channelId'=>$channelId,
'timestamp'=>$timestamp
);
//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法
$url="https://api.polyv.net/live/v3/channel/chat/get-checkin?appId=$appId&channelId=$channelId&checkinId=$checkinId&sign=$sign×tamp=$timestamp";
$ch = curl_init() or die ( curl_error() );
curl_setopt( $ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT, 360);
$response = curl_exec ( $ch );
curl_close ( $ch );
echo $response;
?>
Loading...