將智慧卡指派給要求
將指定的智慧卡繫結至指定的要求。 智慧卡系結之後,只能使用指定的卡片來執行要求。
注意
本文中的 URL 相對於 API 部署期間所選擇的主機名稱,例如 https://api.contoso.com
。
要求
方法 | 要求 URL |
---|---|
POST | /CertificateManagement/api/v1.0/smartcards |
URL 參數
無。
要求標頭
如需常見的要求標頭,請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭。
要求本文
要求本文包含下列屬性:
屬性 | 描述 |
---|---|
requestid | 要系結至智慧卡的要求識別碼。 |
cardid | 智慧卡的 cardid。 |
atr | 智慧卡的重設回應 (ATR) 字串。 |
回應
本節說明回應。
回應碼
程式碼 | 描述 |
---|---|
201 | 建立時間 |
204 | 沒有內容 |
403 | 禁止 |
500 | 內部錯誤 |
回應標頭
如需常見的回應標頭,請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭。
回應本文
成功時,會傳回新建立智慧卡物件的 URI。
範例
本節提供系結智慧卡的範例。
範例:要求
POST /CertificateManagement/api/v1.0/smartcards HTTP/1.1
{
"requestid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
"cardid":"bc88f13f-83ba-4037-8262-46eba1291c6e",
"atr":"3b8d0180fba000000397425446590301c8"
}
範例:回應
HTTP/1.1 201 Created
"api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9"