• Post category:Профили
  • Запись изменена:03.11.2022

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 Time Roundtrip format: 2008-04-10T06-30-00.000Z
worksfrom

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

необязательно
Date and Time Roundtrip 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>