Перейти к основному содержимому

RegisterConfirm

Подтверждает владение закрытым ключом сертификата для регистрации в организацию методом Register.

POST /RegisterConfirm

Заголовки запроса

Тело запроса

Тело запроса должно содержать запрос на подтверждение владения закрытым ключом сертификата, представленный структурой RegistrationConfirmRequest.

Коды ответа

  • 200 — операция успешно завершена.
  • 400 — данные в запросе имеют неверный формат, или отсутствуют обязательные параметры, или предоставлен невалидный контент подписи.
  • 401 — в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.
  • 403 — запрос сделан от заблокированного клиента API.
  • 405 — используется неподходящий HTTP-метод.
  • 409 — текущее состояние регистрации не требует подтверждения.
  • 415 — тип содержимого запроса не поддерживается.
  • 429 — превышено ограничение на количество запросов в единицу времени.
  • 500 — при обработке запроса возникла непредвиденная ошибка.

Примеры использования

Пример HTTP-запроса:

POST /RegisterConfirm HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/json; charset=utf-8
Accept: application/json

Пример тела запроса с телом сертификата:

{
"CertificateContent": "<certificateBytesBase64>",
"DataToSign": "<dataToSignBytesBase64>",
"Signature": "<signatureBytesBase64>"
}

Пример тела запроса с отпечатком сертификата:

{
"Thumbprint": "B0E10292B0024E7197A76B741CE0D271FEAD7E10",
"DataToSign": "<dataToSignBytesBase64>",
"Signature": "<signatureBytesBase64>"
}

Пример запроса с использованием C# SDK:

var request = new RegistrationRequest
{
Thumbprint = certificate.Sha1Thumbprint
};

var response = api.Register(token, request);

if (response.RegistrationStatus == RegistrationStatus.CertificateOwnershipProofIsRequired)
{
api.RegisterConfirm(
token,
new RegistrationConfirmRequest
{
Thumbprint = certificate.Sha1Thumbprint,
DataToSign = response.DataToSign,
Signature = Sign(response.DataToSign, certificate)
});

response = api.Register(token, request);
}

if (response.RegistrationStatus == RegistrationStatus.RegistrationIsInProcess)
{
Thread.Sleep(TimeSpan.FromSeconds(5));
response = api.Register(token, request);
}

Console.WriteLine(string.Format("BoxId: {0}, Status: {1}", response.BoxId, response.RegistrationStatus);

См. также

Инструкции:

Методы для работы с организациями:

  • GetBox — возвращает данные ящика по указанному идентификатору
  • GetMyOrganizations — возвращает список организаций, в которых пользователь является сотрудником
  • GetOrCreateRoamingOrganizationByFnsParticipantId — находит или создает роуминговую организацию по идентификатору участника ЭДО
  • GetOrganization — возвращает данные организации по указанному идентификатору
  • GetOrganizationFeatures — возвращает список дополнительных функций организации
  • GetOrganizationsByInnKpp — возвращает данные организации по ИНН
  • GetOrganizationsByInnList (V2) — возвращает список организаций и их статус партнерства по списку ИНН
  • GetOrganizationsByForeignTaxpayerCode — возвращает данные организации по коду иностранного налогоплательщика
  • GetResolutionRoutes — возвращает список всех неудаленных включенных маршрутов согласования для указанного ящика
  • Register — находит или создает в Диадоке организацию по сертификату и добавляет владельца сертификата в сотрудники этой организации
  • RegisterConfirm — подтверждает владение закрытым ключом сертификата для регистрации в организацию
  • SearchFnsParticipants — ищет участников ЭДО в роуминге по ИНН, КПП или идентификатору участника ЭДО
  • SendFnsRegistrationMessage — отправляет заявление участника ЭДО для указанного ящика

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года