Назначение смарт-карты запросу
Привязывает указанную смарт-карту к заданному запросу. После привязки смарт-карты запрос можно выполнить только с указанной картой.
Примечание
URL-адреса в этой статье относятся к имени узла, выбранному во время развертывания API, например https://api.contoso.com.
Запрос
| Метод | URL-адрес запроса |
|---|---|
| POST | /CertificateManagement/api/v1.0/smartcards |
Параметры URL-адреса
Нет.
Заголовки запросов
Общие заголовки запросов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.
Текст запроса
Текст запроса содержит следующие свойства:
| Свойство | Описание |
|---|---|
| RequestID | Идентификатор запроса для привязки к смарт-карте. |
| cardid | Идентификатор cardid смарт-карты. |
| atr | Строка ATR (Answer-to-reset) смарт-карты. |
Ответ
В этом разделе описывается ответ.
Коды ответов
| Код | Описание |
|---|---|
| 201 | Создание |
| 204 | Нет содержимого |
| 403 | Запрещено |
| 500 | Внутренняя ошибка |
Заголовки ответов
Общие заголовки ответов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.
Текст ответа
В случае успешного выполнения возвращается URI вновь созданного объекта смарт-карты.
Пример
В этом разделе приведен пример привязки смарт-карты.
Пример. Запрос
POST /CertificateManagement/api/v1.0/smartcards HTTP/1.1
{
"requestid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
"cardid":"bc88f13f-83ba-4037-8262-46eba1291c6e",
"atr":"3b8d0180fba000000397425446590301c8"
}
Пример: Ответ
HTTP/1.1 201 Created
"api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9"