Пользователи #3028
Через API вы можете получить необходимую информацию по пользователям: ФИО, должность, контактные данные и другие параметры пользователей.
Список пользователей
Запрос
GET http://api.megacrm.ru/v1/users
Ответ
Ответ содержит параметр «result», в котором находится список объектов пользователей:
Название параметра |
Тип |
Описание |
id |
Натуральное число |
ID метки |
first_name |
Строка |
Имя |
last_name |
Строка |
Фамилия |
patronymic |
Строка |
Отчество |
|
Строка |
Email-адрес |
gender |
Целое число |
Пол: 1 — муж 2 — жен |
owner |
Логический |
Владелец аккаунта |
created |
Время в unix timestamp |
Время создания пользователя |
updated |
Время в unix timestamp |
Время последнего изменения пользователя |
category |
Объект должности пользователя |
Должность |
custom_fields |
Список объектов значений доп. полей |
Значения дополнительных полей |
Пример
GET https://api.megacrm.ru/v1/users X-MegaCrm-ApiAccount: 12345678 X-MegaCrm-ApiSignature: a93ce6de86e0ae482c9511e49164e22cfdbdea2a478397fb12afe40ba4226b08 HTTP/1.1 200 OK Server: nginx/1.14.0 (Ubuntu) Date: Wed, 17 Oct 2018 13:28:45 GMT Content-Type: application/json; charset=UTF-8 Transfer-Encoding: chunked Connection: keep-alive X-Dev: crm { "result": [ { "id": 123456, "first_name": "Мама дяди Фёдора", "last_name": "", "patronymic": "", "email": "mama@prostokvashino.ru", "gender": 2, "owner": true, "created": 252450000, "updated": 252450000, "category": { "id": 1, "creator_id": 0, "name": "Директор", "description": "", "position": 0, "created": 252450000, "updated": 252450000, "deletable": false }, "custom_fields": [] } ] }
Список должностей
Запрос
GET http://api.megacrm.ru/v1/users/category
Ответ
Ответ содержит параметр «result», в котором находится список объектов должностей:
Название параметра |
Тип |
Описание |
id |
Натуральное число |
ID метки |
creator_id |
Натуральное число |
ID пользователя, который создал должность |
name |
Строка |
Название |
description |
Строка |
Описание |
position |
Целое число |
Порядок следования должности в общем списке |
created |
Время в unix timestamp |
Время создания должности |
updated |
Время в unix timestamp |
Время последнего изменения должности |
deletable |
Логический |
Должность можно удалить |
Пример
GET https://api.megacrm.ru/v1/users/categories X-MegaCrm-ApiAccount: 12345678 X-MegaCrm-ApiSignature: abcdef0123456789 HTTP/1.1 200 OK Content-Type: application/json; charset=UTF-8 { "result": [ { "id": 1, "creator_id": 0, "name": "Директор", "description": "", "position": 0, "created": 252450000, "updated": 252450000, "deletable": false } ] }