WORKSECTION

Участники

Получение списка пользователей через API: get_users

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

?action=get_users
Возвращает данные пользователей аккаунта

Возвращаемые данные:
  • id — ID пользователя
  • first_name — имя пользователя
  • last_name — фамилия пользователя
  • name — имя и фамилия пользователя
  • title — должность пользователя
  • rate — ставка пользователя (если указано)
  • avatar — ссылка на изображение аватарки пользователя
  • group — название команды
  • department — название отдела
  • role — роль пользователя:
  • owner — владелец
    account admin — администратор аккаунта
    team admin — администратор команды
    department admin — администратор отдела
    user — пользователь
    guest — гость
    reader — читатель 
  • email — email пользователя
  • phone — основной номер телефона (если указано)
  • phone2 — рабочий номер телефона (если указано) 
  • phone3 — мобильный номер телефона (если указано) 
  • phone4 — домашний номер телефона (если указано) 
  • address — адрес (если указано) 
  • address2 — дополнительный адрес (если указано) 

Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": [
        {
            "id": "USER_ID",
            "first_name": "USER_FIRST_NAME_1",
            "last_name": "USER_LAST_NAME_1",
            "name": "USER_NAME",
            "title": "USER_POSITION", "rate": USER_RATE,
            "avatar": "URL",
            "group": "USER_GROUP",
            "department": "USER_DEPARTMENT",
            "role": "USER_ROLE",
            "email": "USER_EMAIL",
            "phone": "USER_PHONE",
            "phone2": "USER_PHONE_2",
            "phone3": "USER_PHONE_3",
            "address": "USER_ADDRESS",
            "address2": "USER_ADDRESS_2"
        },
        {
            "id": "USER_ID",             "first_name": "USER_FIRST_NAME_2",             "last_name": "USER_LAST_NAME_2", ... ... ...
}
    ]
}
Эта статья была вам полезна? Да, спасибо! Нет

Приглашение пользователя в аккаунт через API: add_user

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

?action=add_user&email=USER_EMAIL
Приглашение в аккаунт нового пользователя
*в вашу команду, если не указан параметр group

Обязательные параметры:
  • email — email пользователя

Необязательные параметры:
  • first_name — имя пользователя
  • last_name — фамилия пользователя
  • title — должность пользователя
  • group — название команды
  • department — название отдела
  • role — роль пользователя. Доступные варианты:
user — пользователь
guest — гость
reader — читатель 

Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": {
        "id": "USER_ID",
        "first_name": "USER_FIRST_NAME",
        "last_name": "USER_LAST_NAME",
        "name": "USER_NAME",
        "title": "USER_POSITION",
"rate": USER_RATE,
        "avatar": "URL",
        "group": "GROUP_NAME",
        "department": "USER_DEPARTMENT",
        "role": "USER_ROLE",
        "email": "USER_EMAIL"
    }
}
Эта статья была вам полезна? Да, спасибо! Нет

Получение списка наименований команд участников через API: get_user_groups

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

?action=get_user_groups
Возвращает список команд участников аккаунта

Возвращаемые данные:
  • id — ID команды
  • title — название команды
  • client — тип команды:
0 — внутренняя команда компании
1 — клиентская команда

Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": [
        {
            "id": "GROUP_ID",
            "title": "GROUP_NAME",
            "type": "company",
            "client": 0
        },
        {
            "id": "GROUP_ID",
            "title": "GROUP_NAME",
            "type": "company",
            "client": 1
        }
    ]
}
Эта статья была вам полезна? Да, спасибо! Нет

Создание команды для участников в аккаунте через API: add_user_group

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

?action=add_user_group&title=USER_GROUP
Создает команду
*при отсутствии команды с аналогичным названием

Обязательные параметры:
  • title — название команды

Необязательные параметры:
  • client 1 для клиентской команды и 0 для команды компании

Пример JSON ответа
При успешном выполнении, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": {
        "id": "GROUP_ID",
        "title": "USER_GROUP_NAME",
        "type": "company",
        "client": 1
    }
}
Эта статья была вам полезна? Да, спасибо! Нет

Получение списка контактов через API: get_contacts

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

?action=get_contacts
Возвращает информацию по контактам аккаунта

Возвращаемые данные:
  • id — ID контакта
  • first_name — имя контакта
  • last_name — фамилия контакта
  • name — имя и фамилия контакта
  • title — должность контакта
  • group — название папки контактов
  • email — email контакта
  • phone — основной номер телефона (если указано)
  • phone2 — рабочий номер телефона (если указано) 
  • phone3 — мобильный номер телефона (если указано) 
  • phone4 — домашний номер телефона (если указано) 
  • address — адрес (если указано) 
  • address2 — дополнительный адрес (если указано) 

Пример JSON ответа
При успешном выполнении, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": [
        {
            "id": "CONTACT_ID",
            "first_name": "CONTACT_FIRST_NAME",
            "last_name": "CONTACT_LAST_NAME",
            "name": "CONTACT_NAME",
            "title": "CONTACT_POSITION",
            "group": "CONTACT_GROUP",
            "email": "CONTACT_EMAIL",
            "phone": "CONTACT_PHONE",
            "phone2": "CONTACT_PHONE_2",
            "phone3": "CONTACT_PHONE_3",
            "phone4": "CONTACT_PHONE_4",
            "address": "CONTACT_ADDRESS",
            "address2": "CONTACT_ADDRESS_2"
        }, { "id": "CONTACT_ID", "first_name": "CONTACT_FIRST_NAME", "last_name": "CONTACT_LAST_NAME", ... ... ... }
    ]
}
Эта статья была вам полезна? Да, спасибо! Нет

Создание контакта через API: add_contact

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

?action=add_contact&name=CONTACT_NAME&email=CONTACT_EMAIL
Создает контакт
*не имеет доступа в аккаунт

Обязательные параметры:
  • email — email контакта
  • name — имя и фамилия контакта

Необязательные параметры:
  • title — должность контакта
  • group — название папки контактов
  • phone — основной номер телефона контакта
  • phone2 — рабочий номер телефона 
  • phone3 — мобильный номер телефона 
  • phone4 — домашний номер телефона 
  • address — адрес контакта
  • address2 — дополнительный адрес контакта

Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": {
        "id": "CONTACT_ID",
        "first_name": "CONTACT_FIRST_NAME",
        "last_name": "CONTACT_LAST_NAME",
        "name": "CONTACT_NAME",
        "title": "CONTACT_POSITION",
        "group": "GROUP_NAME",
        "email": "CONTACT_EMAIL",
        "phone": "CONTACT_PHONE",
        "phone2": "CONTACT_PHONE_2",
        "phone3": "CONTACT_PHONE_3",
        "phone4": "CONTACT_PHONE_4",
        "address": "CONTACT_ADDRESS",
        "address2": "CONTACT_ADDRESS_2"
    }
}
Эта статья была вам полезна? Да, спасибо! Нет

Получение списка наименований папок для контактов через API: get_contact_groups

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

?action=get_contact_groups
Возвращает данные по папкам для контактов аккаунта

Возвращаемые данные:
  • id — ID папки
  • title — название папки
  • type — тип папки:
preset — папка для контактов, созданная по умолчанию
folder — папка для контактов, созданная участником аккаунта

Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": [
        {
            "id": "GROUP_ID",
            "title": "GROUP_NAME",
            "type": "preset"
        },
        {
            "id": "GROUP_ID",
            "title": "GROUP_NAME",
            "type": "folder"
        }
    ]
}
Эта статья была вам полезна? Да, спасибо! Нет

Создание папки для контактов через API: add_contact_group

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

?action=add_contact_group&title=CONTACT_GROUP
Создает папку для контактов
*при отсутствии папки с аналогичным названием

Обязательные параметры:
  • title — название папки для контактов

Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": {
        "id": "CONTACT_GROUP_ID",
        "title": "CONTACT_GROUP",
        "type": "folder"
    }
}
Эта статья была вам полезна? Да, спасибо! Нет

Подписать пользователя на задачу через API: subscribe

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

?action=subscribe&id_task=TASK_ID&email_user=USER_EMAIL
Подписывает пользователя на указанное задание
*список подписчиков задания можно получить через метод get_task при указании параметра extra=subscribers

Обязательные параметры:
  • id_task — ID задания
  • email_user — email пользователя

Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok

{
    "status": "ok"
}

Эта статья была вам полезна? Да, спасибо! Нет

Отписать пользователя от задачи через API: unsubscribe

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

?action=unsubscribe&id_task=TASK_ID&email_user=USER_EMAIL
Отписывает пользователя от указанного задания
*список подписчиков задания можно получить через метод get_task при указании параметра extra=subscribers

Обязательные параметры:
  • id_task — ID задания
  • email_user — email пользователя

Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok

{
    "status": "ok"
}

Эта статья была вам полезна? Да, спасибо! Нет

Получение информации об авторизованном пользователе через API: me

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

?action=me
Возвращает информацию об авторизованном пользователе (oauth2)

метод доступен только при использовании токена доступа

Возвращаемые данные:
  • id — ID пользователя
  • first_name — имя пользователя
  • last_name — фамилия пользователя
  • name — имя и фамилия пользователя
  • title — должность пользователя
  • avatar — ссылка на изображение аватарки пользователя
  • group — название команды
  • department — название отдела
  • role — роль пользователя:
  • owner — владелец
    account admin — администратор аккаунта
    team admin — администратор команды
    department admin — администратор отдела
    user — пользователь
    guest — гость
    reader — читатель 
  • email — email пользователя
  • phone — основной номер телефона (если указано)
  • phone2 — рабочий номер телефона (если указано) 
  • phone3 — мобильный номер телефона (если указано) 
  • phone4 — домашний номер телефона (если указано) 
  • address — адрес (если указано) 
  • address2 — дополнительный адрес (если указано) 

Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": [
        {
            "id": "USER_ID",
            "first_name": "USER_FIRST_NAME_1",
            "last_name": "USER_LAST_NAME_1",
            "name": "USER_NAME",
            "title": "USER_POSITION", "rate": USER_RATE,
            "avatar": "URL",
            "group": "USER_GROUP",
            "department": "USER_DEPARTMENT",
            "role": "USER_ROLE",
            "email": "USER_EMAIL",
            "phone": "USER_PHONE",
            "phone2": "USER_PHONE_2",
            "phone3": "USER_PHONE_3",
            "address": "USER_ADDRESS",
            "address2": "USER_ADDRESS_2"
        }
    ]
}
Эта статья была вам полезна? Да, спасибо! Нет
Вторжение России в Украину Worksection прекратил работу на территории РФ Почему?
esc
или
Распечатать