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"