Compartilhar via


Atribuir um cartão inteligente a uma solicitação

Associa o cartão inteligente especificado à solicitação especificada. Depois que um cartão inteligente é associado, a solicitação só pode ser executada com o cartão especificado.

Observação

As URLs neste artigo são relativas ao nome do host escolhido durante a implantação da API, como https://api.contoso.com.

Solicitação

Método URL da solicitação
POST /CertificateManagement/api/v1.0/smartcards

Parâmetros de URL

Nenhum.

Cabeçalhos da solicitação

Para cabeçalhos de solicitação comuns, consulte Cabeçalhos de solicitação e resposta HTTP nos detalhes do serviço da API REST do CM.

Corpo da solicitação

O corpo da solicitação contém as seguintes propriedades:

Propriedade Descrição
requestid A ID da solicitação a ser associada ao cartão inteligente.
cardid A cardid do cartão inteligente.
atr A cadeia de ATR (resposta para redefinição) do cartão inteligente.

Resposta

Esta seção descreve a resposta.

Códigos de resposta

Código Descrição
201 Criado
204 Sem conteúdo
403 Proibido
500 Erro Interno

Cabeçalhos de resposta

Para cabeçalhos de resposta comuns, consulte Cabeçalhos de solicitação e resposta HTTP nos detalhes do serviço da API REST do CM.

Corpo da resposta

Em caso de êxito, retorna um URI para o objeto do cartão inteligente recém-criado.

Exemplo

Esta seção fornece um exemplo para associar um cartão inteligente.

Exemplo: Solicitação

POST /CertificateManagement/api/v1.0/smartcards HTTP/1.1

{
    "requestid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
    "cardid":"bc88f13f-83ba-4037-8262-46eba1291c6e",
    "atr":"3b8d0180fba000000397425446590301c8"
}

Exemplo: resposta

HTTP/1.1 201 Created

"api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9"

Confira também