物聯網卡流量查詢接口

步驟 1 創建阿里云賬號

為了訪問服務，您需要有一個阿里云賬號。如果沒有，可首先按照如下步驟創建阿里云賬號：

訪問阿里云 官方網站，單擊頁面上的 免費注冊 按鈕。

按照屏幕提示完成注冊流程并進行實名認證，該服務只支持實名認證用戶使用。為了更好地使用阿里云服務，建議盡快完成實名認證，否則部分阿里云服務將無法使用。具體實名認證流程，請參考 這里。

步驟 2 獲取阿里云訪問密鑰

為了使用物聯卡 SDK，您必須申請阿里云的訪問密鑰。

阿里云訪問秘鑰是阿里云為用戶使用 API(非控制臺)來訪問其云資源設計的“安全口令”。您可以用它來簽名 API 請求內容以通過服務端的安全驗證。

該訪問秘鑰成對(AccessKeyId 與 AccessKeySecret)生成和使用。每個阿里云用戶可以創建多對訪問秘鑰，且可隨時啟用(Active)、禁用(Inactive)或者刪除已經生成的訪問秘鑰對。

您可以通過阿里云控制臺的 秘鑰管理頁面 創建、管理所有的訪問秘鑰對，且保證它處于“啟用”狀態。由于訪問秘鑰是阿里云對 API 請求進行安全驗證的關鍵因子，請妥善保管你的訪問秘鑰。如果某些秘鑰對出現泄漏風險，建議及時刪除該秘鑰對并生成新的替代秘鑰對。

步驟 3 在控制臺完成購卡行為后，且卡被用戶正常激活后，獲得調用接口必備的參數

ICCID

請到阿里云控制臺下的物聯網無線服務下的卡管理頁面，獲取已經正常激活的卡對應的iccid值

參數請求參數名稱

類型

是否必須

描述

Iccid

String

必須

需要查詢的物聯卡對應的Iccid編碼

其他請求參數請參見 公共請求參數

出參列表出參名稱

出參類型

樣例取值

參數說明

RequestId

String

8906582E-6722

請求ID

Code

String

OK

狀態碼-返回OK代表請求成功,其他錯誤碼詳見錯誤碼列表

Message

String

請求成功

狀態碼的描述

CardFlowInfos

Object

-

該對象為一個list，list元素請參考下面的CardFlowInfo樣例

CardFlowInfo樣例出參名稱

出參類型

樣例取值

參數說明

ResourceType

String

6700001

資源類型編碼： 6700001代表流量

ResName

String

物聯網-聯通-Internet-自定義流量包

資源名稱(提醒：物聯網-測試期套餐僅在api可以查詢，控制臺僅在轉為正式套餐后展現剩余流量)

FlowResource

Number

1048576

資源總量 (流量單位為KB)

RestOfFlow

Number

1048576

資源剩余量 (流量單位為KB)

FlowUsed

Number

0

資源使用量 (流量單位為KB)

ValidDate

String

20171106174912

資源生效日期

ExpireDate

String

20180504235959

資源失效日期

SmsUsed

Number

389

短信使用量 單位(條)

VoiceUsed

Number

25

語音使用量 單位(分鐘)

VoiceTotal

Number

60

語音套餐總量(如果有語音套餐包) 單位(分鐘)

公共返回參數，詳見 公共請求參數

技術對接步驟

1:下載SDK工具包

SDK&DEMO[下載地址]

2: 編寫樣例程序

下載SDK后，路徑在：dyiotapi_python.zip\python-dyiotapi\api_demo\aliyun-python-sdk-dyiotapi-demo.py內查看demo。

返回示例

JSON示例{

/*請求標簽，用于追蹤錯誤*/

"RequestId":"1C63F16F-D376-4065-816E-3E56CDD13FEB",

/*請求code，OK代表正常*/

"Code":"OK",

/*異常描述*/

"Message":"ServiceUnavailable"

"CardFlowInfos":[

{

/*資源類型編碼*/

"ResourceType":"6700001",

/*資源名*/

"ResName":"物聯網-聯通-Internet-自定義流量包",

/*資源總量KB*/

"FlowResource":1048576,

/*資源余量KB*/

"RestOfFlow":1048576,

/*資源使用量KB*/

"FlowUsed":0,

/*生效時間*/

"ValidDate":"20171106174912",

/*失效時間*/

"ExpireDate":"20180504235959",

/*生效時間預留字段可忽略*/

"ValidDate":"20171106174912",

/*失效時間預留字段可忽略*/

"ExpireDate":"20180504235959",

/*短信使用量單位(條)*/

"SmsUsed":389,

/*語音使用量單位(分鐘)*/

"VoiceUsed":25,

/*語音套餐總量(如果有語音套餐包)單位(分鐘)*/

"VoiceTotal":60

}

]

}

錯誤碼錯誤代碼

描述

Http狀態碼

語義

isv.RES_OWNER_ID_UNKNOWN

Can’t found of the card owner.

400

卡資源歸屬無效

isv.PRODUCT_UN_SUBSCRIPT

The Product need to order，before invoke the API.

400

未開通物聯卡產品

isv.IOT_RES_NOT_EXIST

Can’t found the card by the iccid number.

400

IccId對應的卡資源不存在

isv.QUERY_ASSETS_ERROR

Query user infomation of the card response is error.

400

卡對應的用戶資料異常

isv.RAM_PERMISSION_DENY

The invoker is permission invoke the API for the card.

400

當前調用者無權對該卡發起請求

isv.SYSTEM_ERROR

System error.

404

系統異常

總結

以上是生活随笔為你收集整理的物联卡查询流量_物联卡流量查询_python_API文档_开发指南_物联网无线连接服务 - 阿里云...的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。