Register

POST /Register
Request Headers:
 
Status Codes:
  • 200 OK – операция успешно завершена
  • 400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры
  • 401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization, или в этом заголовке содержатся некорректные авторизационные данные
  • 405 Method Not Allowed – используется неподходящий HTTP-метод
  • 500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка

Тело запроса: RegistrationRequest

Тело ответа: RegistrationResponse

  1. Находит или создает в Диадоке организацию по сертификату
  2. Добавляет владельца сертификата в сотрудники этой организации или создает запрос на доступ администраторам

Поиск и создание организации

Метод выполняет поиск организации в Диадоке по ИНН сертификата. Если организация еще не работает в Диадоке, для нее будет создан ящик на основе данных ЕГРЮЛ/ЕГРИП.

Добавление сотрудника

Условия и логика добавления сотрудника в организацию описаны в статье руководства пользователя сервиса Диадок.

В процессе регистрации может потребоваться подтверждение владения закрытым ключом сертификата с помощью метода RegisterConfirm.

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

Примеры запросов

С телом сертификата

POST /Register HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: DiadocAuth ddauth_api_client_id=key, ddauth_token=token
Content-Type: application/json; charset=utf-8

{
    "CertificateContent": "<certificateBytesBase64>"
}

С отпечатком сертификата

POST /Register HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: DiadocAuth ddauth_api_client_id=key, ddauth_token=token
Content-Type: application/json; charset=utf-8

{
    "Thumbprint": "B0E10292B0024E7197A76B741CE0D271FEAD7E10"
}

Примеры ответов

Регистрация завершилась созданием сотрудника

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "RegistrationStatus": "RegistrationIsCompleted",
    "BoxId": "99a4b249-a144-4f11-9d7b-4d84fdb68f8b"
}

Требуется подтвердить владение закрытым ключом

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "RegistrationStatus": "CertificateOwnershipProofIsRequired",
    "BoxId": "2d81936a-d304-4b70-83bc-ab964e7a0f60",
    "DataToSign": "<bytesBase64>"
}

Пример с использованием 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);