該接口用于查詢物聯網卡的卡狀態分布數據。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetSimCardStateDistribution | 系統規定參數。取值:GetSimCardStateDistribution。 |
CredentialNO | String | 否 | CT-SC-M-2-100M | 套餐憑證編號,您可在物聯網SIM服務控制臺的憑證管理頁面查看。 |
Date | String | 是 | 202209 | 查詢的日期。 格式:yyyyMM。 |
返回數據
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
Code | String | 200 | 接口返回碼。 200:表示成功。 其它:表示錯誤碼。錯誤碼詳情,請參見錯誤碼。 |
ErrorMessage | String | InstanceId cannot be empty. | 調用失敗時,返回的錯誤信息。 |
RequestId | String | E4F94B97-1D64-4080-BFD2-67461667AA43 | 請求ID,阿里云為該請求生成的標識符。 |
Success | Boolean | true | 是否調用成功。 true:調用成功。 false:調用失敗。 |
Data | Object | 返回數據。 |
|
CardCount | Long | 100 | 卡總數。 |
TestCount | Long | 20 | 可測試卡數量。 |
UnusedCount | Long | 10 | 未使用卡數量。 |
StopCount | Long | 5 | 已停用卡數量。 |
DestoryedCount | Long | 0 | 已銷戶卡數量。 |
UsingCount | Long | 50 | 使用中卡數量。 |
ShutDownCount | Long | 10 | 已停機卡數量。 |
示例
請求示例
http(s)://linkcard.aliyuncs.com/?Action=GetSimCardStateDistribution
&Date=202209&CredentialNO=CT-SC-M-2-100M
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<GetSimCardStateDistributionResponse>
<code>200</code>
<data>
<RequestId>5C06CF1A-959D-10A9-9C56-003EDF663BAF</RequestId>
<Data>
<StopCount>166</StopCount>
<TestCount>50098</TestCount>
<UnusedCount>426</UnusedCount>
<CardCount>902847</CardCount>
<DestoryedCount>340498</DestoryedCount>
<UsingCount>511007</UsingCount>
<ShutDownCount>652</ShutDownCount>
</Data>
<Success>true</Success>
</data>
<httpStatusCode>200</httpStatusCode>
<requestId>5C06CF1A-959D-10A9-9C56-003EDF663BAF</requestId>
<successResponse>true</successResponse>
</GetSimCardStateDistributionResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"code" : "200",
"data" : {
"RequestId" : "5C06CF1A-959D-10A9-9C56-003EDF663BAF",
"Data" : {
"StopCount" : 166,
"TestCount" : 50098,
"UnusedCount" : 426,
"CardCount" : 902847,
"DestoryedCount" : 340498,
"UsingCount" : 511007,
"ShutDownCount" : 652
},
"Success" : true
},
"httpStatusCode" : "200",
"requestId" : "5C06CF1A-959D-10A9-9C56-003EDF663BAF",
"successResponse" : true
}