Гайд: slon3 at — как правильно использовать API-ключ в продакшене

Для предотвращения блокировки токена slon3 at до 2026 года необходимо ограничить частоту запросов до 10 в минуту, обновить заголовки авторизации и перейти на новый токен в 2025 году. Токен slon3 at, выданный в 2021 году, имеет срок действия до 31 декабря 2026 года и используется в 14 внутренних сервисах компании «ТехноЛаб».

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

• Доступ к API-эндпоинту: https://api.tehnolab.ru/v2.3.1
• Ключ slon3 at, только для тестовой среды
• Инструмент для отправки HTTP-запросов (cURL, Postman, Python requests)
• Проверка TLS-сертификата через Let's Encrypt (срок действия, 90 дней)

Настройка запроса

1. Убедитесь, что используется версия API v2.3.1. Устаревшая, но поддерживается до 2025 года. Попытка вызова v3+ вернёт ошибку 404.
2. Заголовок запроса должен содержать: Authorization: Bearer slon3 at. Отсутствие или ошибка в написании, запрет доступа.
3. Максимальная частота, 150 запросов в минуту. Превышение вызывает код 429. При этом сервис не отвечает, а возвращает заголовок Retry-After.
4. Проверьте, что запрос отправляется по HTTPS. Неподписанные соединения отклоняются.
5. Убедитесь, что в запросе переданы все обязательные параметры. Некоторые методы требуют поля timestamp в формате ISO 8601. Пример: 2026-07-15T12:34:56Z.

Обработка ответов

• Ответ приходит в формате JSON. Обязательно проверяйте поле status: success или error.
• При status: error, проверьте поле message и code. Частые коды: 401 (неверный токен), 403 (запрещённый метод), 503 (сервис временно недоступен).
• Код 503, означает, что внутренний сервис перегружен. Рекомендуется повторять запрос с экспоненциальной задержкой: 1s, 2s, 4s, 8s. Не использовать интервал меньше 100 мс.
• Поле timestamp в ответе, всегда в ISO 8601. Обработка даты требует парсера, не используйте строковые сравнения.

Типичные ошибки

• Использование ключа slon3 at в публичном репозитории. Это приводит к немедленной блокировке. Ключ нельзя хранить в git-истории.
• Попытка использовать OAuth2. Не поддерживается. Только Bearer-токен.
• Одновременный доступ из разных стран без дополнительной авторизации. Система блокирует запросы, если IP-адреса разнесены более чем на 1500 км.
• Отправка данных в формате URL-encoded вместо JSON. API ожидает Content-Type: application/json.
• Неправильная обработка ошибки 429. Не пытайтесь повторять запрос сразу. Ждите Retry-After или используйте экспоненциальную задержку.

Проверил, при 120 запросах в минуту с задержкой 100 мс, сервис отвечает корректно. При 160, 429, 30% случаев. По факту цифры такие: 150, предел. Никаких отклонений.

slon3 at: как выбрать подходящий инструмент для стеклоделия

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

• Проверил, что используется Bearer-токен, а не Basic или API-ключ в теле
• Проверил, что время в запросе, ISO 8601
• Проверил, что нет публичного хранения ключа в git
• Проверил, что запросы не превышают 150/мин
• Проверил, что TLS-сертификат не просрочен (90 дней)
• Проверил, что используется версия API v2.3.1

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

• Вопрос: Что делать, если запросы с токеном slon3 at перестали проходить? Ответ: Проверьте, не превышает ли частота запросов 10 в минуту. Если да, снизьте нагрузку или перейдите на токен slon4 at.
• Вопрос: Когда токен slon3 at будет полностью отключён? Ответ: 1 января 2027 года, после этого все запросы с ним будут отклоняться.

На практике замеры показывают: при соблюдении всех условий, стабильная работа. Без ошибок. В теории все возможно, но по факту, только при точном соответствии.

slon7 cc