UpdateMyUser

POST /UpdateMyUser
Request Headers:
 
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 – при обработке запроса возникла непредвиденная ошибка

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

Тело ответа: 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
}

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