Zuweisen einer Smartcard zu einer Anforderung
Bindet die angegebene Smartcard an die angegebene Anforderung. Nachdem eine Smartcard gebunden wurde, kann die Anforderung nur mit der angegebenen Karte ausgeführt werden.
Hinweis
Die URLs in diesem Artikel beziehen sich auf den Hostnamen, der während der API-Bereitstellung ausgewählt wird, z. B. https://api.contoso.com.
Anfrage
| Methode | Anforderungs-URL |
|---|---|
| SENDEN | /CertificateManagement/api/v1.0/smartcards |
URL-Parameter
Keiner.
Anforderungsheader
Allgemeine Anforderungsheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM-REST-API-Dienstdetails.
Anfragekörper
Der Anforderungstext enthält die folgenden Eigenschaften:
| Eigentum | BESCHREIBUNG |
|---|---|
| requestid | Die ID der Anforderung, die an die Smartcard gebunden werden soll. |
| cardid | Die Karten-ID der Smartcard. |
| Atr | Die Smartcard-Antwort-zu-Zurücksetzungszeichenfolge (ATR). |
Antwort
In diesem Abschnitt wird die Antwort beschrieben.
Antwortcodes
| Code | BESCHREIBUNG |
|---|---|
| 201 | Erstellt |
| 204 | Kein Inhalt |
| 403 | Verboten |
| 500 | Interner Fehler |
Antwortheader
Allgemeine Antwortheader finden Sie unter HTTP-Anforderungs- und Antwortheader in CM REST API-Dienstdetails.
Antwortkörper
Gibt bei Erfolg einen URI an das neu erstellte Smartcardobjekt zurück.
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"