UpdateMyUser

POST /UpdateMyUser
Request Headers:
Request Body:

Тело запроса должно содержать структуру UserToUpdate.

Status Codes:

  • 200 OK – операция успешно завершена.

  • 400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.

  • 401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.

  • 405 Method Not Allowed – используется неподходящий HTTP-метод.

  • 405 Method Not Allowed – происходит попытка обновить login на уже зарегистрированный на портале.

  • 500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

Response Body:

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

Позволяет изменить данные текущего авторизованного пользователя, от имени которого делается запрос. В запросе достаточно передать значения только тех реквизитов пользователя, которые необходимо изменить.

Изменение логина пользователя произойдет только после подтверждения нового адреса электронной почты.

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

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

POST /UpdateMyUser 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

{
    "Login":
    {
        "Login": "newLogin@kontur.ru"
    },
    "FullName":
    {
        "FullName":
        {
            "FirstName": "NewFirstName",
            "LastName": "NewLastName",
            "MiddleName": "NewMiddleName"
        }
    }
}

Запрос приведет к тому, что у пользователя будет обновлено ФИО, а также на адрес newLogin@kontur.ru будет направлено письмо с ссылкой для подтверждения нового логина.

Пример запроса для обновления ФИО:

POST /UpdateMyUser 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

{
    "FullName":
    {
        "FullName":
        {
            "FirstName": "NewFirstName",
            "LastName": "NewLastName",
            "MiddleName": "NewMiddleName"
        }
    }
}

Запрос приведет к тому, что у пользователя будет обновлено только ФИО.

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

api.UpdateMyUser(token, new UserToUpdate
    {
        Login = new UserLoginPatch
        {
            Login = "newLogin@kontur.ru"
        },
        FullName = new UserFullNamePatch
        {
            FullName = new FullName
            {
                FirstName = "NewFirstName",
                LastName = "NewLastName",
                MiddleName = "NewMiddleName"
            }
        }
    });

Пример ответа:

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

{
    "UserId": "d064f6ba-7b81-432d-a41d-93b23eebe579",
    "Login": "login@kontur.ru",
    "FullName":
    {
        "FirstName": "NewFirstName",
        "LastName": "NewLastName",
        "MiddleName": "NewMiddleName"
    },
    "IsRegistered": true
}

До тех пор, пока пользователь не перейдет по ссылке в высланном при смене логина письме, в ответе будет указано старое значение логина.