Hämta smartkort föreslagna PIN-kodGet Smartcard Proposed PIN

Hämtar servergenererade användaren PIN-kod.Gets the server-generated user PIN.

Obs: servern ställer in PIN-koden endast om mallen profilprincip anger att det ska göras.Note: The server will set the PIN only if the profile template policy indicates that it should be done. I annat fall måste användaren ange den.Otherwise, the user should supply it.

Obs: URL: er som visas i det här avsnittet är i förhållande till värdnamnet valt under distributionen av API, till exempel: https://api.contoso.com.Note: URLs shown in this topic are relative to the hostname chosen during API deployment; for example: https://api.contoso.com.

BegäranRequest

MetodMethod URL-begäranRequest URL
GETGET /CertificateManagement/API/v1.0/SmartCards/{ID}/serverproposedpin/CertificateManagement/api/v1.0/smartcards/{id}/serverproposedpin

URL-parametrarURL Parameters

ParameterParameter BeskrivningDescription
IDid Smartkort identifierare (MIM CM-specifik).The smartcard identifier (MIM CM specific). Hämtas från Microsft.Clm.Shared.Smartcard-objektet.Obtained from the Microsft.Clm.Shared.Smartcard object.

FrågeparametrarQuery Parameters

ParameterParameter BeskrivningDescription
ATRatr Kort atr.The card atr.
av CardIdcardid Kort-id.The card id.
utmaningchallenge En Base64-kodad sträng som representerar anrop utfärdat av smartkortet.A base-64 encoded string representing the challenge issued by the smartcard.

Huvuden för begäranRequest Headers

Vanliga begärandehuvuden finns HTTP-begäran och svarshuvuden i CM REST API-tjänsteinformation.For common request headers, see HTTP Request and Response Headers in CM REST API Service Details.

BegärandetextenRequest Body

ingetnone

SvarResponse

SvarskoderResponse Codes

KodCode BeskrivningDescription
200200 OKOK
204204 Inget innehållNo content
403403 Tillåts inteForbidden
500500 Internt felInternal Error

SvarsrubrikerResponse Headers

Vanliga svarshuvuden finns HTTP-begäran och svarshuvuden i CM REST API-tjänsteinformation.For common response headers, see HTTP Request and Response Headers in CM REST API Service Details.

SvarstextenResponse Body

Returnerar en sträng som representerar PIN-koden föreslagna av servern på åtgärden lyckades.On success, returns a string that represents the PIN proposed by the server.

ExempelExample

BegäranRequest

GET GET /CertificateManagement/api/v1.0/smartcards/C6BAD97C-F97F-4920-8947-BE980C98C6B5/serverproposedpin HTTP/1.1

SvarResponse

HTTP/1.1 200 OK

... body coming soon