返回值
所有返回值一律为JSON格式,返回的 HTTP 状态码为 2xx,代表调用成功。返回 4xx 或 5xx 的 HTTP 状态码代表调用失败。形如:
{
"code": 200,
"msg": "success",
"data": {
"user_id": 16417997
}
}
成功结果示例
{
"code": 200,
"msg": "success",
"data": {
"user_id": 16417997
}
}
错误结果示例
{
"code": 500,
"msg": "服务请求错误",
"data": {},
}
响应公共参数说明
参数名 |
类型 |
说明 |
code |
int |
接口响应code码,根据code码进行逻辑处理和判断 |
msg |
string |
接口响应消息,对于code码的基本描述 |
data |
object |
接口响应数据对象,接口响应的主要数据在data字段中返回 |
其它响应字段说明
参数名 |
类型 |
说明 |
list |
array |
数据列表 |
total |
int |
总条数 |
请求示例PHP版
$url = 'https://zhike.vhall.com/api/v1/activity/activity-lists';
$post_data = array(
'key'=>'xxx',
'subject'=>'vhall',
'start_time'=>1376934451,
);
$data = http_build_query($post_data);
$ch = curl_init();
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_TIMEOUT, 6);
$result = curl_exec($ch);
curl_close($ch);
var_dump($result);//操作成功,返回{'code':200,'data':'123456789'}
错误码