該接口用于給物聯網卡添加標簽。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | AddTagsToCard | 系統規定參數。取值:AddTagsToCard。 |
Iccid | String | 是 | 89860321******15668 | 物聯網卡的ICCID。 您可在物聯網卡上查看ICCID,或者在物聯網SIM服務控制臺的卡管理頁面查看ICCID。 |
TagNameList | Array of String | 否 | 測試標簽 | 標簽名稱。 參數為空或者空集合的時候代表從卡上刪除所有標簽。 如標簽不存在,則會自動創建該標簽并打標。 |
返回數據
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
Code | String | 200 | 接口返回碼。 200:表示成功。 其它:表示錯誤碼。錯誤碼詳情,請參見錯誤碼。 |
Data | Array of data | 該卡已有標簽的集合。 |
|
TagName | String | 測試標簽 | 標簽名稱。 |
TagId | String | 14 | 標簽ID。 |
ErrorMessage | String | InstanceId cannot be empty. | 調用失敗時,返回的錯誤信息。 |
RequestId | String | E4F94B97-1D64-4080-BFD2-67461667AA43 | 請求ID,阿里云為該請求生成的標識符。 |
Success | Boolean | true | 是否調用成功。 true:調用成功。 false:調用失敗。 |
示例
請求示例
http(s)://[Endpoint]/?Action=AddTagsToCard
&Iccid=89860321******15668
&TagNameList=["測試標簽"]
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<AddTagsToCardResponse>
<Code>200</Code>
<Data>
<TagName>測試標簽</TagName>
<TagId>14</TagId>
</Data>
<ErrorMessage>InstanceId cannot be empty.</ErrorMessage>
<RequestId>E4F94B97-1D64-4080-BFD2-67461667AA43</RequestId>
<Success>true</Success>
</AddTagsToCardResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Code" : "200",
"Data" : [ {
"TagName" : "測試標簽",
"TagId" : "14"
} ],
"ErrorMessage" : "InstanceId cannot be empty.",
"RequestId" : "E4F94B97-1D64-4080-BFD2-67461667AA43",
"Success" : true
}