Compartir a través de

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
PUBLICAR /CertificateManagement/api/v1.0/smartcards

Parámetros de dirección URL

Ninguno.

Encabezados de solicitud

Para obtener encabezados de solicitud comunes, consulte encabezados de solicitud y respuesta HTTP en detalles del servicio de 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 Cardid de la tarjeta inteligente.
Atr Cadena de respuesta a restablecimiento de tarjeta inteligente (ATR).

Respuesta

En esta sección se describe la respuesta.

Códigos de respuesta

Código Descripción
201 Creado
204 Sin contenido
403 Prohibido
500 Error interno

Encabezados de respuesta

Para obtener encabezados de respuesta comunes, consulte encabezados de solicitud y respuesta HTTP en detalles del servicio de API REST de CM.

Cuerpo de la respuesta

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"

Consulte también