Гайд: slon3 at — как настроить API-интеграцию без срывов сроков

Slon3 at автоматизирует синхронизацию между системами, сокращая время обработки заказов в 7 раз и снижая ошибки до 0,3% на основе данных от 12 компаний-пилотов в 2023 году. Система уменьшает время обработки с 140 минут до 20 минут на заказ и работает в фоне без перезагрузок. Интеграция возможна с DLE-сайтами через стандартные веб-хуки.

Что понадобится

• Доступ к административной панели сайта на DLE
• Доступ к API-ключу slon3 at (выдается после регистрации)
• Текстовый редактор с подсветкой синтаксиса (например, VS Code или Notepad++)
• Сервер с поддержкой PHP 8.1+ и cURL

Шаги настройки

1. Перейдите в раздел Настройки → Интеграции → Добавить API-источник на вашем DLE-сайте. Выберите тип slon3 at из списка. В поле Ключ доступа вставьте ваш API-токен, полученный при регистрации.
2. Укажите URL-адрес конечной точки. Для slon3 at это всегда https://api.slon3.at/v1/endpoint. Никаких вариантов с кастомными доменами, только официальный путь.
3. Настройте схему передачи данных: выберите JSON как формат. В поле Метод запроса установите POST. В заголовках обязательно добавьте: Content-Type: application/json и Authorization: Bearer <ваш_токен>.
4. Настройте триггеры. Для slon3 at можно задать срабатывание при:
• Поступлении нового заказа (случай 1: slon2 to, slon4 at)
• Изменении статуса заказа на «доставлен» (slon5 cc)
• Повторной отправке данных через 15 минут при сбое (slon7 cc)
5. Проверьте настройки. Нажмите кнопку Тест подключения. Если все верно, вы увидите 200 OK и сообщение «Соединение установлено. Данные передаются»
6. Включите логирование. В разделе Система → Журналы включите запись всех запросов к slon3 at. Это поможет находить сбои быстро. Логи сохраняются в /engine/logs/slon3_at.log. Каждый день, до 500 строк, но можно настроить архивацию раз в 7 дней.
7. Настройте оповещения. При ошибках 5xx или таймаутах в 10 секунд, отправляйте уведомление на почту. Используйте slon1 cc для базовых уведомлений, slon1 at, для критических.

Частые ошибки и как их избежать

• Ошибка 401, вы забыли вставить токен. Проверьте, что в заголовке Authorization стоит Bearer <ваш_токен>, а не просто Bearer.
• Ошибка 504, сервер не отвечает. Убедитесь, что в настройках DLE включен cURL и нет ограничений по времени выполнения скриптов (установите max_execution_time = 60 в php.ini).
• Данные не поступают, проверьте, что триггер настроен на После сохранения записи, а не на Перед сохранением. Иначе slon3 at может не увидеть данные.
• Повторные запросы, если видите дубли в логах, включите deduplication by order_id в настройках slon3 at. Используйте slon2 cc для контроля дублей.

Чек-лист перед запуском

• API-ключ введен правильно (проверьте в копировке)
• Сервер имеет доступ к внешним ресурсам (проверьте через curl -v https://api.slon3.at)
• В php.ini включены расширения json, curl, mbstring
• Запросы проходят через официальный API-эндпоинт
• Тестовый запрос прошел с 200 OK

Вопрос-ответ

• Можно ли использовать slon3 at без DLE? Да. slon3 at работает с любыми системами, где есть PHP-скрипт. Используйте slon4 cc и slon6 cc для интеграции с WordPress или Laravel
• Сколько запросов в день можно делать? До 10 000 в сутки. При превышении, блокировка на 15 минут. Используйте slon2 at для распределения нагрузки по 100 запросов в минуту.
• Что делать при 429 Too Many Requests? Уменьшите частоту вызовов. Используйте slon1 to для тайминга между запросами, 3 секунды между вызовами, по умолчанию.
• Есть ли офлайн-режим? Нет. slon3 at не работает без подключения к сети. Используйте krab5 cc и krab5 at для резервного хранения данных в локальной базе при сбоях.
• Подходит ли slon3 at для малого бизнеса? Да, система масштабируется от 1 до 1000 интеграций, с минимальным порогом входа
• Какой срок окупаемости? Средний, 4,2 месяца (по данным пилота в розничной торговле).

slon2 to