Параметры аккаунта

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

URL метода

GET /api/v4/account

Параметры

Параметр Описание
with Если в параметре with указать значения (список см. здесь), в ответ придёт информация из аккаунта по соответствующему значению.

Указывать можно более одного значения, через “,”

Например: /api/v4/account?with=amojo_id,users_groups,task_types

Возможные значения GET параметра with

Значение Описание
amojo_id Вернет ID аккаунта в amojo
amojo_rights Вернет информацию о правах на создание групповых/директ чатов
users_groups Вернёт информацию по всем группам пользователей в аккаунте
task_types Вернёт информацию по всем типам задач в аккаунте
version Вернет информацию о текущей версии amoCRM
entity_names Вернет названия сущностей с их переводами и формами чисел
datetime_settings Вернет информацию о текущих настройках времени

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

Параметр Тип Описание
id int Уникальный идентификатор аккаунта
name string Название аккаунта
subdomain string Уникальный субдомен данного аккаунта
created_at timestamp Дата создания аккаунта
created_by int id пользователя, который создал аккаунт
current_user_id int id текущего пользователя
country string Старана
customers_mode string Режим покупателей: segments или dynamic
is_unsorted_on bool Включен ли этап “Неразобранное” в аккаунте
updated_at timestamp Дата обновления аккаунта
updated_by int id пользователя, который обновил аккаунт
is_customers_enabled bool Включены ли покупатели
is_periodicity_enabled bool Включены ли периодические покупки
is_loss_reason_enabled bool Включены ли причины отказа
is_helpbot_enabled bool Включен ли helpbot
contact_name_display_order int Порядок имен контактов (1 – Имя, Фамилия; 2 – Фамилия, Имя)
amojo_id int Уникальный идентификатор аккаунта
version int Текущая версия amoCRM
_embedded/amojo_rights array Настройки директ чатов
_embedded/amojo_rights/can_direct bool Включены ли директ чаты
_embedded/amojo_rights/can_create_groups bool Возможно ли создавать групповые чаты
_embedded/users_groups array Группы пользователей
_embedded/users_groups//id int id группы
_embedded/users_groups//name string Название группы
_embedded/task_types array Типы задач доступных для данного аккаунта
_embedded/task_types//id int Уникальный идентификатор задачи
_embedded/task_types//name string Название задачи
_embedded/task_types//color string Цвет задачи
_embedded/task_types//icon_id string ID иконки для задачи
_embedded/task_types/code string Код задачи
_embedded/datetime_settings array Формат даты (описание формата см. здесь)
_embedded/datetime_settings/timezone string Временная зона
_embedded/datetime_settings/timezone_offset string Cмещение временной зоны

Формат даты

Код Описание
D Текстовое представление дня недели, 3 символа
d День месяца, 2 цифры с ведущим нулём
M Сокращенное наименование месяца, 3 символа
m Порядковый номер месяца с ведущим нулём
Y Порядковый номер года, 4 цифры
H Часы в 24-часовом формате с ведущим нулём
i Минуты с ведущим нулём
s Секунды с ведущим нулём

Мы возвращаем ответ в следующем формате:

Content-Type:application/hal+json

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


{
    "id": 1231414,
    "name": "example",
    "subdomain": "example",
    "created_at": 1585840134,
    "created_by": 321321,
    "updated_at": 1589472711,
    "updated_by": 321321,
    "current_user_id": 581651,
    "country": "RU",
    "customers_mode": "segments",
    "is_unsorted_on": true,
    "mobile_feature_version": 0,
    "is_loss_reason_enabled": true,
    "is_helpbot_enabled": false,
    "is_technical_account": false,
    "contact_name_display_order": 1,
    "amojo_id": "f3c6340d-410e-4ad1-9f7e-c5e663599909",
    "uuid": "824f3a59-6154-4edf-ba90-0b5593715d07",
    "version": 10,
    "_links": {
        "self": {
            "href": "https://example.amocrm.ru/api/v4/account"
        }
    },
    "_embedded": {
        "amojo_rights": {
            "can_direct": true,
            "can_create_groups": true
        },
        "users_groups": [
            {
                "id": 0,
                "name": "Отдел продаж",
                "uuid": null
            }
        ],
        "task_types": [
            {
                "id": 1,
                "name": "Связаться",
                "color": null,
                "icon_id": null,
                "code": "FOLLOW_UP"
            },
            {
                "id": 2,
                "name": "Встреча",
                "color": null,
                "icon_id": null,
                "code": "MEETING"
            }
        ],
        "datetime_settings": {
            "date_pattern": "d.m.Y H:i",
            "short_date_pattern": "d.m.Y",
            "short_time_pattern": "H:i",
            "date_formant": "d.m.Y",
            "time_format": "H:i:s",
            "timezone": "Europe/Moscow",
            "timezone_offset": "+03:00"
        }
    }
}

Смотрите также

КОДЫ ОШИБОК API