Zuweisen einer Smartcard zu einer Anforderung
Bindet die angegebene Smartcard an die angegebene Anforderung. Nachdem eine Smartcard gebunden ist, kann die Anforderung nur mit der angegebenen Karte ausgeführt werden.
Hinweis
Die URLs in diesem Artikel sind relativ zum Hostnamen, der während der API-Bereitstellung ausgewählt wird, z. B https://api.contoso.com. .
Anforderung
| Methode | Anforderungs-URL |
|---|---|
| POST | /CertificateManagement/api/v1.0/smartcards |
URL-Parameter
Keine.
Anforderungsheader
Allgemeine Anforderungsheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.
Anforderungstext
Der Anforderungstext enthält die folgenden Eigenschaften:
| Eigenschaft | BESCHREIBUNG |
|---|---|
| requestid | Die ID der Anforderung, an die Smartcard zu binden. |
| cardid | Die Karten-ID der Smartcard. |
| atr | Die ATR-Zeichenfolge (Antwort zum Zurücksetzen) der Smartcard. |
Antwort
In diesem Abschnitt wird die Antwort beschrieben.
Antwortcodes
| Code | BESCHREIBUNG |
|---|---|
| 201 | Erstellt |
| 204 | Kein Inhalt |
| 403 | Verboten |
| 500 | Interner Fehler |
Antwortheader
Informationen zu allgemeinen Antwortheadern finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.
Antworttext
Bei Erfolg wird ein URI für das neu erstellte Smartcard-Objekt zurückgegeben.
Beispiel
Dieser Abschnitt enthält ein Beispiel zum Binden einer Smartcard.
Beispiel: Anforderung
POST /CertificateManagement/api/v1.0/smartcards HTTP/1.1
{
"requestid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
"cardid":"bc88f13f-83ba-4037-8262-46eba1291c6e",
"atr":"3b8d0180fba000000397425446590301c8"
}
Beispiel: Antwort
HTTP/1.1 201 Created
"api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9"