基础 qianmi.qmcs.user.get(获取用户已开通消息)
获取用户已开通消息
用户授权类型
不需要授权
公共参数
请求地址:
系统级请求参数:
环境 | HTTP请求地址 | HTTPS请求地址 | 正式环境 | http://gw.api.qianmi.com/api | https://api.qianmi.com/api |
---|
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
method | String | 必须 | API接口名称 |
access_token | String | 可选 | 用户登录授权以后,QMOP颁发给应用的授权信息,详细介绍请点击这里,当前API的用户授权类型标明:"需要授权",则此参数必传,"不需要授权",则此参数不需要传。 |
format | String | 必须 | 指定响应格式,目前支持格式为json |
appKey | String | 必须 | 分配给应用的AppKey |
v | String | 必须 | API协议版本,当前可选值:1.1 |
sign | String | 必须 | API输入参数签名结果 |
timestamp | String | 必须 | 请求时间戳,时区为GMT+8(北京时间),格式:"yyyy-MM-dd HH:mm:ss",例如"2012-12-20 10:20:35",开放平台允许客户端请求的最大时间误差为10分钟 |
业务参数
名称 | 类型 | 是否必须 | 示例值 | 默认值 | 描述 |
---|---|---|---|---|---|
user_id | String | 必须 | A854800 | 用户编号 | |
fields | String | 必须 | user_id,group_name,topics | 需要返回的字段,多个字段之间以逗号分隔 |
请求示例
OpenClient client = new DefaultOpenClient(url, appKey, appSecret); QmcsUserGetRequest req = new QmcsUserGetRequest(); req.setUserId("admin_id"); req.setFields("fields_1,fields_2"); QmcsUserGetResponse response = client.execute(req, accessToken);
$client = new OpenClient; $client->appKey = appKey; $client->appSecret = appSecret; $req = new QmcsUserGetRequest; $req->setUserId("admin_id"); $req->setFields("fields_1,fields_2"); $res = $client->execute($req, $accessToken);
IOpenClient client = new DefaultOpenClient(url, appKey, appSecret); QmcsUserGetRequest req = new QmcsUserGetRequest(); req.UserId = "admin_id"; req.Fields = "fields_1,fields_2"; QmcsUserGetResponse response = client.Execute(req, accessToken);
响应参数
名称 | 类型 | 示例值 | 描述 |
---|
响应示例
异常示例
{ "errorToken": "@@$-ERROR_TOKEN$-@@", "code": "33", "message": "非法的参数", "solution": "请查看根据服务接口对参数格式的要求", "subErrors": { "subError": [{ "code": "isv.invalid-paramete:XXXX", "message": "参数XXXX无效,格式不对、非法值、越界等" }] }
错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
isv.qianmi-qmcs-user-get-service-error:01074006 | 未查询到用户已开通的消息,请检查用户编号是否正确并确认用户是否已开通消息 | 请检查用户编号是否正确并确认用户是否已开通消息 |
API工具
FAQ