Dela via


Tilldela ett smartkort till en begäran

Binder det angivna smartkortet till den angivna begäran. När ett smartkort är bundet kan begäran endast köras med det angivna kortet.

Anteckning

URL:erna i den här artikeln är relativa till det värdnamn som väljs under API-distributionen, till exempel https://api.contoso.com.

Förfrågan

Metod Begärans-URL
POST /CertificateManagement/api/v1.0/smartcards

URL-parametrar

Inga.

Begärandehuvuden

Vanliga begärandehuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.

Begärandetext

Begärandetexten innehåller följande egenskaper:

Egenskap Beskrivning
Id ID:t för begäran om att binda till smartkortet.
cardid Smartkortets cardid.
Atr Smartkortssträngen answer-to-reset (ATR).

Svarsåtgärder

I det här avsnittet beskrivs svaret.

Svarskoder

Kod Beskrivning
201 Skapad
204 Inget innehåll
403 Förbjudet
500 Internt fel

Svarshuvuden

Vanliga svarshuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.

Själva svaret

Vid lyckat resultat returnerar en URI till det nyligen skapade smartkortsobjektet.

Exempel

Det här avsnittet innehåller ett exempel för att binda ett smartkort.

Exempel: Begäran

POST /CertificateManagement/api/v1.0/smartcards HTTP/1.1

{
    "requestid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
    "cardid":"bc88f13f-83ba-4037-8262-46eba1291c6e",
    "atr":"3b8d0180fba000000397425446590301c8"
}

Exempel: Svar

HTTP/1.1 201 Created

"api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9"

Se även