## 一、概述
對當前卡片的查詢操作；
## 二、接口
~~~[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);
```
