物聯(lián)網(wǎng)卡流量查詢接口

步驟 1 創(chuàng)建阿里云賬號(hào)

為了訪問(wèn)服務(wù)，您需要有一個(gè)阿里云賬號(hào)。如果沒(méi)有，可首先按照如下步驟創(chuàng)建阿里云賬號(hào)：

訪問(wèn)阿里云 官方網(wǎng)站，單擊頁(yè)面上的 免費(fèi)注冊(cè) 按鈕。

按照屏幕提示完成注冊(cè)流程并進(jìn)行實(shí)名認(rèn)證，該服務(wù)只支持實(shí)名認(rèn)證用戶使用。為了更好地使用阿里云服務(wù)，建議盡快完成實(shí)名認(rèn)證，否則部分阿里云服務(wù)將無(wú)法使用。具體實(shí)名認(rèn)證流程，請(qǐng)參考 這里。

步驟 2 獲取阿里云訪問(wèn)密鑰

為了使用物聯(lián)卡 SDK，您必須申請(qǐng)阿里云的訪問(wèn)密鑰。

阿里云訪問(wèn)秘鑰是阿里云為用戶使用 API(非控制臺(tái))來(lái)訪問(wèn)其云資源設(shè)計(jì)的“安全口令”。您可以用它來(lái)簽名 API 請(qǐng)求內(nèi)容以通過(guò)服務(wù)端的安全驗(yàn)證。

該訪問(wèn)秘鑰成對(duì)(AccessKeyId 與 AccessKeySecret)生成和使用。每個(gè)阿里云用戶可以創(chuàng)建多對(duì)訪問(wèn)秘鑰，且可隨時(shí)啟用(Active)、禁用(Inactive)或者刪除已經(jīng)生成的訪問(wèn)秘鑰對(duì)。

您可以通過(guò)阿里云控制臺(tái)的 秘鑰管理頁(yè)面 創(chuàng)建、管理所有的訪問(wèn)秘鑰對(duì)，且保證它處于“啟用”狀態(tài)。由于訪問(wèn)秘鑰是阿里云對(duì) API 請(qǐng)求進(jìn)行安全驗(yàn)證的關(guān)鍵因子，請(qǐng)妥善保管你的訪問(wèn)秘鑰。如果某些秘鑰對(duì)出現(xiàn)泄漏風(fēng)險(xiǎn)，建議及時(shí)刪除該秘鑰對(duì)并生成新的替代秘鑰對(duì)。

步驟 3 在控制臺(tái)完成購(gòu)卡行為后，且卡被用戶正常激活后，獲得調(diào)用接口必備的參數(shù)

ICCID

請(qǐng)到阿里云控制臺(tái)下的物聯(lián)網(wǎng)無(wú)線服務(wù)下的卡管理頁(yè)面，獲取已經(jīng)正常激活的卡對(duì)應(yīng)的iccid值

參數(shù)請(qǐng)求參數(shù)名稱

類型

是否必須

描述

Iccid

String

必須

需要查詢的物聯(lián)卡對(duì)應(yīng)的Iccid編碼

其他請(qǐng)求參數(shù)請(qǐng)參見(jiàn) 公共請(qǐng)求參數(shù)

出參列表出參名稱

出參類型

樣例取值

參數(shù)說(shuō)明

RequestId

String

8906582E-6722

請(qǐng)求ID

Code

String

OK

狀態(tài)碼-返回OK代表請(qǐng)求成功,其他錯(cuò)誤碼詳見(jiàn)錯(cuò)誤碼列表

Message

String

請(qǐng)求成功

狀態(tài)碼的描述

CardFlowInfos

Object

-

該對(duì)象為一個(gè)list，list元素請(qǐng)參考下面的CardFlowInfo樣例

CardFlowInfo樣例出參名稱

出參類型

樣例取值

參數(shù)說(shuō)明

ResourceType

String

6700001

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

ResName

String

物聯(lián)網(wǎng)-聯(lián)通-Internet-自定義流量包

資源名稱(提醒：物聯(lián)網(wǎng)-測(cè)試期套餐僅在api可以查詢，控制臺(tái)僅在轉(zhuǎn)為正式套餐后展現(xiàn)剩余流量)

FlowResource

Number

1048576

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

RestOfFlow

Number

1048576

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

FlowUsed

Number

0

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

ValidDate

String

20171106174912

資源生效日期

ExpireDate

String

20180504235959

資源失效日期

SmsUsed

Number

389

短信使用量 單位(條)

VoiceUsed

Number

25

語(yǔ)音使用量 單位(分鐘)

VoiceTotal

Number

60

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

公共返回參數(shù)，詳見(jiàn) 公共請(qǐng)求參數(shù)

技術(shù)對(duì)接步驟

1:下載SDK工具包

SDK&DEMO[下載地址]

2: 編寫樣例程序

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

返回示例

JSON示例{

/*請(qǐng)求標(biāo)簽，用于追蹤錯(cuò)誤*/

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

/*請(qǐng)求code，OK代表正常*/

"Code":"OK",

/*異常描述*/

"Message":"ServiceUnavailable"

"CardFlowInfos":[

{

/*資源類型編碼*/

"ResourceType":"6700001",

/*資源名*/

"ResName":"物聯(lián)網(wǎng)-聯(lián)通-Internet-自定義流量包",

/*資源總量KB*/

"FlowResource":1048576,

/*資源余量KB*/

"RestOfFlow":1048576,

/*資源使用量KB*/

"FlowUsed":0,

/*生效時(shí)間*/

"ValidDate":"20171106174912",

/*失效時(shí)間*/

"ExpireDate":"20180504235959",

/*生效時(shí)間預(yù)留字段可忽略*/

"ValidDate":"20171106174912",

/*失效時(shí)間預(yù)留字段可忽略*/

"ExpireDate":"20180504235959",

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

"SmsUsed":389,

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

"VoiceUsed":25,

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

"VoiceTotal":60

}

]

}

錯(cuò)誤碼錯(cuò)誤代碼

描述

Http狀態(tài)碼

語(yǔ)義

isv.RES_OWNER_ID_UNKNOWN

Can’t found of the card owner.

400

卡資源歸屬無(wú)效

isv.PRODUCT_UN_SUBSCRIPT

The Product need to order，before invoke the API.

400

未開通物聯(lián)卡產(chǎn)品

isv.IOT_RES_NOT_EXIST

Can’t found the card by the iccid number.

400

IccId對(duì)應(yīng)的卡資源不存在

isv.QUERY_ASSETS_ERROR

Query user infomation of the card response is error.

400

卡對(duì)應(yīng)的用戶資料異常

isv.RAM_PERMISSION_DENY

The invoker is permission invoke the API for the card.

400

當(dāng)前調(diào)用者無(wú)權(quán)對(duì)該卡發(fā)起請(qǐng)求

isv.SYSTEM_ERROR

System error.

404

系統(tǒng)異常

總結(jié)

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

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。