## 一、概述
查詢當前卡片中單卡流量；
## 二、接口
~~~[api]
post:/common/query/flow
*string:rayOauthServerAppId=默認值#頭部參數，應用的appId，聯系廠商獲取
*string:rayOauthServerTimeStamp=默認值#頭部參數，當前時間戳，參考前述算法
*string:rayOauthServerSignature=默認值#頭部參數,簽名，參考前述算法
*string:userCode=默認值#卡片的用戶碼
<<<
success
{
"status": 200,
"code": 200,
"message": "操作成功",
"bizCode": 0,
"timestamp": "1648035781699",
"result": {
"listobject": [
{
"quotaId": 1,
"orderId": 1,
"cardId": 1,
"packageId": 5,
"packageType": 1,
"usedFlow": 3358599.0,
"leftFlow": 5.9555961E7,
"usedRate": 0.05,
"isUsingNow": 1,
"validTime": "2022-03-02 15:49:20",
"invalidTime": "2022-03-30 23:59:59",
"reviseValidTime": "2022-03-02 15:49:20",
"reviseInvalidTime": "2022-03-30 23:59:59",
"flowQuota": 6.291456E7,
"quotaSource": 1,
"createTime": "2021-09-02 15:50:02",
"version": 1
}
]
}
}
<<<
error
{
"status": 200,
"code": 1006,
"message": "當前請求appId無效,請確認是否存在并啟用",
"infoCode": "log202203221515192df",
"bizCode": 0,
"timestamp": "1647933319987"
}
~~~
## 三、關鍵字段
| 字段名稱 || 說明 |
| --- | --- |---|
|statu||狀態 200:成功|
|code||狀態碼 200:成功|
|message||提示消息|
|bizCode||0|
|timestamp||時間戳|
|result|listobject|返回結果|
|| packageId| 套餐包類型 1：基礎包 2：加油包 |
|| packageType | 套餐包類型 1：基礎包 2：加油包 |
|| usedFlow | 已用流量（kb） |
|| leftFlow| 剩余流量（kb） |
|| isUsingNow| 當前是否在用 1是 2 否 |
||flowQuota|總流量（kb）|
||validTime|開始時間|
||invalidTime|失效時間|
||reviseValidTime|調整后有效時間（如果跟上面時間不一致，以此時間為準）|
||reviseInvalidTime|調整后失效時間|
## 四、參考代碼
```
Log4jV2Util.initLog4jV2TestEnv();
String hostUrl = "http://{hosturl}";
String apiUrl = "/common/query/flow";
String appId = "ray40c9903c6";
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.warn(result);
```
