Что такое универсальный API и как через него обмениваться данными с любой системой

Ваш сайт с личными кабинетами работает. Но нужно, чтобы он обменивался данными с 1С, телефонией, платёжным шлюзом, CRM партнёра. Каждая интеграция — это разработка под ключ, десятки часов кода. А если систем несколько — месяцы.

В Falcon Space есть универсальный API, который упрощает интеграции. Вы создаёте SQL-процедуру, и она автоматически становится REST-методом, доступным по HTTP. Принимает JSON/XML, возвращает JSON/XML. Без дополнительного кода. Расскажу, как это работает.

Что такое универсальный API

Обычно для создания API нужен программист, который пишет контроллеры, маршруты, авторизацию, сериализацию. В Falcon Space всё это уже есть. Вы просто:

1. Пишете хранимую процедуру, которая принимает входные параметры и возвращает результат (SELECT).
2. Регистрируете процедуру в настройках API (указываете имя метода, например, «createOrder»).
3. Платформа автоматически создаёт публичный URL: https://вашсайт.ru/api/createOrder.

Всё. Метод готов к вызову из внешних систем (1С, мобильное приложение, Zapier, Postman).

Пример процедуры для создания заказа через API:

CREATE PROCEDURE [api].[create_order]
    @client_email nvarchar(100),
    @product_id int,
    @quantity int
AS
BEGIN
    DECLARE @client_id int;
    SELECT @client_id = client_id FROM clients WHERE email = @client_email;
    IF @client_id IS NULL
    BEGIN
        SELECT 'error' AS status, 'Client not found' AS message;
        RETURN;
    END
    INSERT INTO orders (client_id, product_id, quantity, status, created_at)
    VALUES (@client_id, @product_id, @quantity, 'new', GETDATE());
    SELECT 'success' AS status, SCOPE_IDENTITY() AS order_id;
END

Внешняя система шлёт POST-запрос с JSON:

{
  "client_email": "client@mail.ru",
  "product_id": 123,
  "quantity": 2
}

Ответ: {"status":"success","order_id":456}

Никакой рутины. Процедура написана на SQL, и она же проверяет данные.

Какие методы API мы делали для клиентов

1. Выгрузка заказов в 1С. 1С периодически вызывает метод get_new_orders, получает список новых заказов в JSON и импортирует. Раньше менеджеры вручную переносили заказы из сайта в 1С — теперь всё автоматически.

2. Приём заказов из мобильного приложения. У одного клиента было нативное приложение (iOS/Android). Они вызывали API create_order из приложения. Приложение не знало, что за бэкенд — им было всё равно.

3. Интеграция с коллтрекингом. При звонке клиента АТС вызывала API search_client_by_phone, чтобы отобразить данные клиента на экране оператора. Время реакции — менее секунды.

4. Синхронизация с внешним CRM (AmoCRM). При изменении статуса сделки на сайте вызывался вебхук в AmoCRM, и наоборот — при изменении в AmoCRM обновлялся сайт.

Все эти интеграции сделаны через API Falcon Space без написания дополнительного кода на C#, PHP или Python. Только SQL.

Авторизация и безопасность API

API должен быть защищён. Falcon Space поддерживает несколько методов:

• API-ключ (X-API-Key). Вы передаёте ключ в заголовке. Процедура проверяет его.
• Базовая аутентификация (login/password). Если вызываете от имени пользователя.
• JWT-токены (можно настроить).

Также можно ограничить IP-адреса, с которых разрешены вызовы (например, только IP 1С).

Пример проверки API-ключа в процедуре:

IF @api_key != 'SECRET_KEY'
BEGIN
    SELECT 'error' AS status, 'Unauthorized' AS message;
    RETURN;
END

Все вызовы API логируются (кто, когда, какие параметры, какой ответ). Это помогает отлаживать интеграции.

Как вызвать API из 1С или другого ПО

Большинство систем умеют делать HTTP-запросы. В 1С это HTTPСоединение. Пример (упрощённо):

Запрос = Новый HTTPЗапрос();
Запрос.УстановитьТелоИзСтроки(JSON);
Запрос.Заголовки.Вставить("Content-Type", "application/json");
Соединение = Новый HTTPСоединение("https://вашсайт.ru");
Ответ = Соединение.ОтправитьДляОбработки(Запрос, "/api/create_order");

1С-разработчик справится за час. Мы даём документацию по всем API-методам.

Ограничения и когда API не подходит

• Не используйте API для «тяжёлых» отчётов (миллионы строк) — может истечь таймаут. Для этого делайте асинхронную выгрузку.
• API синхронное, то есть клиент ждёт ответа. Если ваш процесс долгий (>30 секунд), лучше переделать в асинхронный (вызов — ответ «принято» — потом запрос статуса).
• Для потоковой передачи файлов (большие архивы) API не подходит — используйте прямой доступ к файловому менеджеру.

В остальных случаях универсальный API Falcon Space покрывает 90% интеграционных задач.

Сколько стоит настройка API под вашу задачу

Если вы сами пишете SQL-процедуры, создание нового API-метода — 30 минут (написать процедуру, добавить в настройки). Бесплатно.

Если заказываете у нас:

• Простой метод (получение данных, вставка) — 10-20 тыс. руб.
• Сложный метод с логикой, проверками, авторизацией — 20-40 тыс. руб.
• Интеграция с конкретной системой (1С, AmoCRM) — от 50 до 150 тыс. руб (включая написание обработчиков на стороне системы).

API — это сила Falcon Space. Вы можете сделать свой сайт не изолированным, а центром экосистемы, к которому подключаются другие сервисы. Не упускайте эту возможность.

Насколько полезной была статья?