## 一、概述
对当前卡片的查询操作;
## 二、接口
~~~[api]
post:/share/query/card
*string:rayOauthServerAppId=默认值#头部参数,应用的appId,联系厂商获取
*string:rayOauthServerTimeStamp=默认值#头部参数,当前时间戳,参考前述算法
*string:rayOauthServerSignature=默认值#头部参数,签名,参考前述算法
*string:userCode=默认值#用户码
<<<
success
{
"status": 200,
"code": 200,
"message": "操作成功",
"bizCode": 0,
"timestamp": "1647933226173",
"result": {
"cardInfo": {
"cardId": 1,
"userCode": "34750",
"accessCode": "9034750",
"iccidCode": "8986032174469034750",
"cardStatus": 2,
"realNameStatus": 1
}
}
}
<<<
error
{
"status": 200,
"code": 1006,
"message": "当前请求appId无效,请确认是否存在并启用",
"infoCode": "log202203221515192df",
"bizCode": 0,
"timestamp": "1647933319987"
}
~~~
## 三、关键字段
| 字段名称 || 说明 |
| --- | --- |---|
|statu||状态 200:成功|
|code||状态码 200:成功|
|message||提示消息|
|bizCode||0|
|timestamp||时间戳|
|result|cardInfo|返回结果|
|| cardId| 卡号ID |
|| userCode | 用户码 |
|| accessCode | 接入码 |
|| iccidCode | iccid码 |
|| cardStatus | 卡片状态 1:已初始化 2:待使用 3:使用中 4:已停用 100:已弃用 |
|| realNameStatus| 实名状态 100:已实名 1:未实名 |
## 四、参考代码
```
String hostUrl = "http://{hosturl}";
String apiUrl = "/share/query/card";
String appId = "ray40c9903c61";
String appSecret = "46bacebf-f63c-41cc-b29c-5812994a5e83";
Map<String, String> paramap = new HashMap();
paramap.put("userCode", "34750");
String result = OauthCaller.call(hostUrl, apiUrl, appId, appSecret, paramap);
Logger logger = LoggerFactory.getLogger(OauthClientTest.class);
logger.info(result);
```