通过签到ID获取签到记录

接口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&timestamp=$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;

?>

签名规则(config.php文件代码查看)

http://dev.polyv.net/2018/liveproduct/l-api/rule/sign/

以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...