Как авторизоваться в amoCRM из 1С при использовании API v4

← На главную

При переходе на современный протокол обмена данными с amoCRM (API v4) многие разработчики сталкиваются с проблемой авторизации. Старый метод передачи логина и пароля непосредственно в параметрах объекта HTTPСоединение больше не работает, возвращая ошибку 401 Unauthorized. В этой статье мы подробно разберем, как правильно настроить соединение, сформировать заголовки и управлять токенами доступа для стабильной работы интеграции.

Разбор причины ошибки 401

Рассмотрим стандартную ситуацию: разработчик создает объект HTTPСоединение, указывая логин и пароль в конструкторе, и пытается выполнить GET запрос к ресурсу /api/v4/contacts. Несмотря на правильность учетных данных, сервер отклоняет запрос. Выясним причину: начиная с API v4, amoCRM полностью перешла на протокол OAuth 2.0. Это означает, что использование параметров USER_LOGIN и USER_HASH (или пароля) в строке соединения или куках (cookies) запрещено.

Для успешного взаимодействия нам необходимо использовать временный ключ — access_token, который передается в заголовке каждого HTTP-запроса. Проанализируем, как реализовать это в коде 1С.

Шаг 1. Настройка защищенного соединения

Прежде всего, работа с API amoCRM ведется исключительно по защищенному протоколу HTTPS. Проанализируем создание объекта HTTPСоединение. Важно использовать объект ЗащищенноеСоединениеOpenSSL, чтобы избежать проблем с сертификатами и обеспечить поддержку протокола TLS 1.2.


// Определяем параметры подключения
Хост = "ваш_поддомен.amocrm.ru";
Защита = Новый ЗащищенноеСоединениеOpenSSL();

// Обратите внимание: логин и пароль в конструкторе оставляем пустыми
Соединение = Новый HTTPСоединение(Хост, , , , , , Защита);

Шаг 2. Формирование заголовков запроса

Теперь разберем самый важный этап — передачу токена. Согласно документации, авторизация происходит через заголовок Authorization. Тип токена должен быть указан как Bearer. Посмотрим на типичную ошибку начинающих: попытку вставить токен в объект Соответствие неправильным способом (например, подсовывая само соответствие в качестве ключа).

Правильный алгоритм формирования заголовков выглядит следующим образом:

Создаем объект Соответствие.
Добавляем ключ "Authorization".
Значение формируем как строку: слово Bearer, затем обязательный пробел, а затем сам access_token.
Добавляем заголовок "Content-Type" со значением "application/json".


// Предположим, токен уже получен и хранится в переменной ЗначениеAccessToken
Заголовки = Новый Соответствие;
Заголовки.Вставить("Authorization", "Bearer " + СокрЛП(ЗначениеAccessToken));
Заголовки.Вставить("Content-Type", "application/json");

// Создаем запрос с указанием пути и подготовленных заголовков
ПутьКРесурсу = "/api/v4/contacts";
HTTPЗапрос = Новый HTTPЗапрос(ПутьКРесурсу, Заголовки);

Шаг 3. Обработка жизненного цикла токена (OAuth 2.0)

Проанализируем ситуацию, когда ваш код работал вчера, а сегодня снова выдает 401. Это происходит потому, что access_token в amoCRM является временным и живет ровно 24 часа. Для поддержания работоспособности нам необходимо реализовать механизм обновления ключей.

Вместе с основным токеном вы получаете refresh_token. Его срок жизни составляет 3 месяца, но он одноразовый. Если вы получили код состояния 401 в ответе от сервера, выполним следующую последовательность действий:

Отправим POST запрос на адрес /oauth2/access_token.
В теле запроса укажем grant_type=refresh_token и наш сохраненный refresh_token.
Получим новую пару ключей и сохраним их в базе данных (например, в константах или регистре сведений).
Повторим исходный запрос к API с новым токеном.

Шаг 4. Учет лимитов и пагинации

При работе с методами GET (например, получение списка контактов или сделок) важно помнить о двух вещах: лимитах запросов и постраничном выводе данных.

Лимиты: amoCRM разрешает выполнять не более 7 запросов в секунду. При массовой выгрузке данных из 1С рекомендуется делать паузу. Рассмотрим пример:


Ответ = Соединение.ВызватьHTTPМетод("GET", HTTPЗапрос);
Если Ответ.КодСостояния = 429 Тогда
    // Слишком много запросов, ждем секунду и повторяем
    Приостановить(1);
    Ответ = Соединение.ВызватьHTTPМетод("GET", HTTPЗапрос);
КонецЕсли;

Пагинация: По умолчанию запрос к /api/v4/contacts вернет только первые 250 записей. Чтобы получить следующие, нужно добавлять параметр в строку запроса: /api/v4/contacts?page=2. Если данных больше нет, API вернет код 204 No Content. Это не ошибка, а сигнал к прекращению цикла обработки.

Полный пример кода для получения контактов

Сведем все полученные знания в единый рабочий пример кода на языке 1С:


Функция ПолучитьКонтактыAmoCRM(AccessToken, Поддомен) Экспорт
    
    Результат = Новый Структура("Успех, Данные", Ложь, Неопределено);
    
    Хост = Поддомен + ".amocrm.ru";
    Защита = Новый ЗащищенноеСоединениеOpenSSL();
    Соединение = Новый HTTPСоединение(Хост, , , , , , Защита);
    
    Заголовки = Новый Соответствие;
    Заголовки.Вставить("Authorization", "Bearer " + AccessToken);
    Заголовки.Вставить("Content-Type", "application/json");
    
    // Запрашиваем первую страницу контактов
    HTTPЗапрос = Новый HTTPЗапрос("/api/v4/contacts?limit=250", Заголовки);
    
    Попытка
        Ответ = Соединение.ВызватьHTTPМетод("GET", HTTPЗапрос);
        
        Если Ответ.КодСостояния = 200 Тогда
            Результат.Успех = Истина;
            Результат.Данные = Ответ.ПолучитьТелоКакСтроку();
        ИначеЕсли Ответ.КодСостояния = 401 Тогда
            // Здесь должна быть логика обновления токена через refresh_token
            ЗаписьЖурналаРегистрации("AmoCRM", УровеньЖурналаРегистрации.Ошибка, , , "Токен истек");
        КонецЕсли;
    Исключение
        ЗаписьЖурналаРегистрации("AmoCRM", УровеньЖурналаРегистрации.Ошибка, , , ОписаниеОшибки());
    КонецПопытки;
    
    Возврат Результат;
    
КонецФункции

Подведем итог: для успешной авторизации в amoCRM необходимо отказаться от передачи пароля в настройках HTTPСоединение, правильно сформировать объект Соответствие для заголовка Authorization с префиксом Bearer и обязательно предусмотреть механизм обновления access_token по истечении 24 часов.