Страница-источник на сайте falconspace.ru
Ваш сайт с личными кабинетами работает. Но нужно, чтобы он обменивался данными с 1С, телефонией, платёжным шлюзом, CRM партнёра. Каждая интеграция — это разработка под ключ, десятки часов кода. А если систем несколько — месяцы.
В Falcon Space есть универсальный API, который упрощает интеграции. Вы создаёте SQL-процедуру, и она автоматически становится REST-методом, доступным по HTTP. Принимает JSON/XML, возвращает JSON/XML. Без дополнительного кода. Расскажу, как это работает.
Обычно для создания API нужен программист, который пишет контроллеры, маршруты, авторизацию, сериализацию. В Falcon Space всё это уже есть. Вы просто:
Всё. Метод готов к вызову из внешних систем (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, и она же проверяет данные.
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 должен быть защищён. Falcon Space поддерживает несколько методов:
Также можно ограничить IP-адреса, с которых разрешены вызовы (например, только IP 1С).
Пример проверки API-ключа в процедуре:
IF @api_key != 'SECRET_KEY'
BEGIN
SELECT 'error' AS status, 'Unauthorized' AS message;
RETURN;
END
Все вызовы API логируются (кто, когда, какие параметры, какой ответ). Это помогает отлаживать интеграции.
Большинство систем умеют делать HTTP-запросы. В 1С это HTTPСоединение. Пример (упрощённо):
Запрос = Новый HTTPЗапрос();
Запрос.УстановитьТелоИзСтроки(JSON);
Запрос.Заголовки.Вставить("Content-Type", "application/json");
Соединение = Новый HTTPСоединение("https://вашсайт.ru");
Ответ = Соединение.ОтправитьДляОбработки(Запрос, "/api/create_order");
1С-разработчик справится за час. Мы даём документацию по всем API-методам.
В остальных случаях универсальный API Falcon Space покрывает 90% интеграционных задач.
Если вы сами пишете SQL-процедуры, создание нового API-метода — 30 минут (написать процедуру, добавить в настройки). Бесплатно.
Если заказываете у нас:
API — это сила Falcon Space. Вы можете сделать свой сайт не изолированным, а центром экосистемы, к которому подключаются другие сервисы. Не упускайте эту возможность.
