Обновить пользователя

  • Post category:Профили
  • Запись изменена:03.11.2022
Print Friendly, PDF & EmailРаспечатать/сохранить в PDF

PUT api/2.0/people/{userid}

Для этой функции требуется аутентификация.

Описание

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

Параметры

НазваниеОписаниеТипПример
userid

sent in url
ID пользователястроковыйтекст
isVisitor

sent in body
Указывает, является ли это гостем (true) или пользователем (false)логическийtrue
firstname

sent in body
Новое имя пользователястроковыйтекст
lastname

sent in body
Новая фамилия пользователястроковыйтекст
comment

sent in body
Новые комментарии пользователей

необязательно
строковыйтекст
department

sent in body
Новый пользовательский отдел

необязательно
Collection of Guids
title

sent in body
Новое название пользователя

необязательно
строковыйтекст
location

sent in body
Новое местоположение пользователя

необязательно
строковыйтекст
sex

sent in body
Пол нового пользователя (мужской или женский)

необязательно
строковыйтекст
birthday

sent in body
День рождения нового пользователя

необязательно
Date and TimeRoundtrip format: 2008-04-10T06-30-00.000Z
worksfrom

sent in body
Дата регистрации нового пользователя. Если она не указана, то будет установлена текущая дата

необязательно
Date and TimeRoundtrip format: 2008-04-10T06-30-00.000Z
contacts

sent in body
Новый список контактовCollection of Contacts

collection
contacts[0][Type]=GTalk&contacts[0][Value]=my@gmail.com
files

sent in body
Новый URL-адрес фотографии профилястроковыйтекст
disable

sent in body
Отключить пользователя

необязательно
логическийtrue
Пример
PUT api/2.0/people/some+text
Host: yourportal.r7-office.ru
Content-Type: application/json
Accept: application/json

{
  "isVisitor": true,
  "firstname": "some text",
  "lastname": "some text",
  "comment": "some text",
  "department": [
    "9924256a-739c-462b-af15-e652a3b1b6eb",
    "98777e9c-f2a7-4e97-b314-ba9f92c2e882"
  ],
  "title": "some text",
  "location": "some text",
  "sex": "some text",
  "birthday": "2008-04-10T06-30-00.000Z",
  "worksfrom": "2008-04-10T06-30-00.000Z",
  "contacts": [
    {
      "Type": "GTalk",
      "Value": "my@gmail.com"
    }
  ],
  "files": "some text",
  "disable": null
}

Возвращает
Обновленный пользователь

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

application/json

{
  "status": 0,
  "response": {
    "id": "00000000-0000-0000-0000-000000000000",
    "userName": "Mike.Zanyatski",
    "isVisitor": false,
    "firstName": "Mike",
    "lastName": "Zanyatski",
    "email": "my@domain.com",
    "birthday": "2022-10-12T08:51:51.7508377Z",
    "sex": "male",
    "status": 1,
    "activationStatus": 0,
    "terminated": null,
    "department": "Marketing",
    "workFrom": "2022-10-12T08:51:51.7508377Z",
    "location": "Palo Alto",
    "notes": "Notes to worker",
    "displayName": null,
    "title": "Manager",
    "contacts": [
      {
        "type": "GTalk",
        "value": "my@gmail.com"
      }
    ],
    "groups": [
      {
        "id": "00000000-0000-0000-0000-000000000000",
        "name": "Group Name",
        "manager": "Jake.Zazhitski"
      }
    ],
    "avatarMedium": "url to medium avatar",
    "avatar": "url to big avatar",
    "isAdmin": false,
    "isLDAP": false,
    "listAdminModules": [
      "projects",
      "crm"
    ],
    "isOwner": false,
    "cultureName": "en-EN",
    "isSSO": false,
    "avatarSmall": "url to small avatar",
    "profileUrl": ""
  }
}

text/xml

<result>
  <status>0</status>
  <response>
    <id>00000000-0000-0000-0000-000000000000</id>
    <userName>Mike.Zanyatski</userName>
    <isVisitor>false</isVisitor>
    <firstName>Mike</firstName>
    <lastName>Zanyatski</lastName>
    <email>my@domain.com</email>
    <birthday>2022-10-12T08:51:51.7508377Z</birthday>
    <sex>male</sex>
    <status>1</status>
    <activationStatus>0</activationStatus>
    <terminated />
    <department>Marketing</department>
    <workFrom>2022-10-12T08:51:51.7508377Z</workFrom>
    <location>Palo Alto</location>
    <notes>Notes to worker</notes>
    <displayName />
    <title>Manager</title>
    <contacts>
      <type>GTalk</type>
      <value>my@gmail.com</value>
    </contacts>
    <groups>
      <id>00000000-0000-0000-0000-000000000000</id>
      <name>Group Name</name>
      <manager>Jake.Zazhitski</manager>
    </groups>
    <avatarMedium>url to medium avatar</avatarMedium>
    <avatar>url to big avatar</avatar>
    <isAdmin>false</isAdmin>
    <isLDAP>false</isLDAP>
    <listAdminModules>projects</listAdminModules>
    <listAdminModules>crm</listAdminModules>
    <isOwner>false</isOwner>
    <cultureName>en-EN</cultureName>
    <isSSO>false</isSSO>
    <avatarSmall>url to small avatar</avatarSmall>
    <profileUrl></profileUrl>
  </response>
</result>