$integration.customRequest
Продвинутая возможность
Метод позволяет выполнить произвольный запрос к любому методу, который поддерживается на стороне API интеграции, подключенной к проекту.
подсказка
Метод функционально схож с методом
$http.query
для выполнения HTTP-запросов.
Используйте вместо него $integration.customRequest
для обращения к API, имеющим отдельную интеграцию на стороне платформы.Синтаксис
Принимаемые аргументы
Метод принимает 5 обязательных аргументов.
Аргумент | Описание | Тип |
---|---|---|
integrationId | Идентификатор интеграции | Строка |
url | Адрес, по которому вызывается метод | Строка |
method | HTTP-метод запроса | Строка |
headers | Заголовки запроса | Объект или null |
body | Тело запроса | Объект или null |
Возвращаемое значение
Метод возвращает объект со следующими полями.
Поле | Описание | Тип |
---|---|---|
statusCode | Код состояния | Число |
responseHeaders | Заголовки ответа | Объект |
responseBody | Тело ответа | Строка |
Примеры использования
Рассмотрим примеры того, как вызывать при помощи $integration.customRequest
методы API для работы с таблицами Google.
В примерах предположим, что идентификатор интеграции и таблицы сохранены в переменных integrationId
и spreadsheetId
соответственно.