Asignación de una tarjeta inteligente a una solicitud
Enlaza la tarjeta inteligente especificada a la solicitud especificada. Una vez enlazada una tarjeta inteligente, la solicitud solo se puede ejecutar con la tarjeta especificada.
Nota
Las direcciones URL de este artículo son relativas al nombre de host elegido durante la implementación de la API, como https://api.contoso.com.
Solicitud
| Método | URL de solicitud |
|---|---|
| POST | /CertificateManagement/api/v1.0/smartcards |
Parámetros de dirección URL
Ninguno.
Encabezados de solicitud
Para ver los encabezados de solicitud comunes, consulte Encabezados de solicitud y respuesta HTTP en los detalles del servicio de LA API REST de CM.
Cuerpo de la solicitud
El cuerpo de la solicitud contiene las siguientes propiedades:
| Propiedad | Descripción |
|---|---|
| requestid | Identificador de la solicitud que se va a enlazar a la tarjeta inteligente. |
| cardid | El valor de cardid de la tarjeta inteligente. |
| atr | Cadena ATR de la tarjeta inteligente. |
Response
En esta sección se describe la respuesta.
Códigos de respuesta
| Código | Descripción |
|---|---|
| 201 | Creado |
| 204 | Ningún contenido |
| 403 | Prohibido |
| 500 | Error interno |
Encabezados de respuesta
Para ver los encabezados de respuesta comunes, consulte Encabezados de solicitud y respuesta HTTP en los detalles del servicio de LA API REST de CM.
Response body
Si se ejecuta correctamente, devuelve un URI al objeto de tarjeta inteligente recién creado.
Ejemplo
En esta sección se proporciona un ejemplo para enlazar una tarjeta inteligente.
Ejemplo: Solicitud
POST /CertificateManagement/api/v1.0/smartcards HTTP/1.1
{
"requestid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
"cardid":"bc88f13f-83ba-4037-8262-46eba1291c6e",
"atr":"3b8d0180fba000000397425446590301c8"
}
Ejemplo: Respuesta
HTTP/1.1 201 Created
"api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9"