Assegnare una smart card a una richiesta
Associa la smart card specificata alla richiesta specificata. Dopo aver associato una smart card, la richiesta può essere eseguita solo con la scheda specificata.
Nota
Gli URL in questo articolo sono relativi al nome host scelto durante la distribuzione dell'API, ad esempio https://api.contoso.com.
Richiesta
| Metodo | URL richiesta |
|---|---|
| POST | /CertificateManagement/api/v1.0/smartcards |
Parametri URL
Nessuno.
Intestazioni della richiesta
Per le intestazioni di richiesta comuni, vedere Intestazioni di richiesta e risposta HTTP nei dettagli del servizio API REST cm.
Testo della richiesta
Il corpo della richiesta contiene le proprietà seguenti:
| Proprietà | Descrizione |
|---|---|
| IDRichiesta | ID della richiesta da associare alla smart card. |
| cardid | Elemento cardid della smart card. |
| atr | Stringa ATR (Answer-To-Reset) della smart card. |
Risposta
Questa sezione descrive la risposta.
Codici di risposta
| Codice | Descrizione |
|---|---|
| 201 | Data di creazione |
| 204 | Nessun contenuto |
| 403 | Accesso negato |
| 500 | Errore interno |
Intestazioni di risposta
Per le intestazioni di risposta comuni, vedere Intestazioni di richiesta e risposta HTTP nei dettagli del servizio API REST cm.
Corpo della risposta
In caso di esito positivo, restituisce un URI per l'oggetto smart card appena creato.
Esempio
Questa sezione fornisce un esempio per associare una smart card.
Esempio: Richiesta
POST /CertificateManagement/api/v1.0/smartcards HTTP/1.1
{
"requestid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
"cardid":"bc88f13f-83ba-4037-8262-46eba1291c6e",
"atr":"3b8d0180fba000000397425446590301c8"
}
Esempio: Risposta
HTTP/1.1 201 Created
"api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9"