Atribuir um smart card a um pedido
Vincula o smart card especificado ao pedido especificado. Depois de um smart card estar vinculado, o pedido só pode ser executado com o cartão especificado.
Nota
Os URLs neste artigo são relativos ao nome do anfitrião escolhido durante a implementação da API, como https://api.contoso.com.
Pedir
| Método | URL do Pedido |
|---|---|
| POST | /CertificateManagement/api/v1.0/smartcards |
Parâmetros de URL
Nenhum.
Cabeçalhos do pedido
Para obter os cabeçalhos de pedidos comuns, veja Cabeçalhos de pedidos e respostas HTTP nos detalhes do serviço da API REST do CM.
Corpo do pedido
O corpo do pedido contém as seguintes propriedades:
| Propriedade | Descrição |
|---|---|
| requestid | O ID do pedido para vincular ao smart card. |
| cardid | O cardídeo do smart card. |
| atr | A cadeia de resposta a reposição (ATR) do smart card. |
Resposta
Esta secçã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 obter cabeçalhos de resposta comuns, veja Cabeçalhos de pedidos e respostas HTTP nos detalhes do serviço API REST do CM.
Corpo da resposta
Com êxito, devolve um URI ao objeto de smart card recentemente criado.
Exemplo
Esta secção fornece um exemplo para vincular um smart card.
Exemplo: Pedido
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"