Пользователи #3028

Через API вы можете получить необходимую информацию по пользователям: ФИО, должность, контактные данные и другие параметры пользователей.

Список пользователей

Запрос

GET http://api.megacrm.ru/v1/users

 

 

Ответ

Ответ содержит параметр «result», в котором находится список объектов пользователей:

Название параметра

Тип

Описание

id

Натуральное число

ID метки

first_name

Строка

Имя

last_name

Строка

Фамилия

patronymic

Строка

Отчество

email

Строка

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
    }
  ]
}
Была ли статья вам полезна?
Укажите, пожалуйста, почему?
Комментарий