取得智慧卡建議的 PIN
取得伺服器產生的使用者 PIN。
重要
如果設定檔範本原則指出應該完成，伺服器只會設定 PIN。 否則，使用者應該提供 PIN。
注意
本文中的 URL 相對於 API 部署期間所選擇的主機名稱，例如 https://api.contoso.com 。
要求
| 方法 | 要求 URL |
|---|---|
| GET | /CertificateManagement/api/v1.0/smartcards/{id}/serverproposedpin |
URL 參數
| 參數 | 描述 |
|---|---|
| id | MICROSOFT IDENTITY MANAGER (MIM 專用的智慧卡識別碼，) 憑證管理 (CM) 。 識別碼是從 Microsft.Clm.Shared.Smartcard 物件取得。 |
查詢參數
| 參數 | 描述 |
|---|---|
| atr | 智慧卡的重設回應 (ATR) 字串。 |
| cardid | 智慧卡識別碼。 |
| challenge | Base-64 編碼字串，代表智慧卡所發出的挑戰。 |
要求標頭
如需常見的要求標頭，請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭。
要求本文
無。
回應
本節描述回應。
回應碼
| 程式碼 | 描述 |
|---|---|
| 200 | [確定] |
| 204 | 沒有內容 |
| 403 | 禁止 |
| 500 | 內部錯誤 |
回應標頭
如需常見的回應標頭，請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭。
回應本文
成功時，傳回字串，表示伺服器所建議的 PIN。
範例
本節提供取得伺服器產生的使用者 PIN 的範例。
範例：要求
GET GET /CertificateManagement/api/v1.0/smartcards/C6BAD97C-F97F-4920-8947-BE980C98C6B5/serverproposedpin HTTP/1.1
範例：回應
HTTP/1.1 200 OK
... body coming soon