Правила использования API
Ознакомьтесь с правилами и ограничениями использования Night Search API для обеспечения стабильной работы сервиса
Конфиденциальность токена
Защита вашего API токена является критически важной
Запрещена передача вашего API-токена третьим лицам. Токен привязан к вашему IP-адресу и предназначен только для вашего использования.
Наказание за нарушение
При обнаружении передачи токена третьим лицам производится немедленное изъятие токена без возврата средств.
Рекомендации по безопасности
- Храните токен в защищенном окружении
- Не передавайте токен в открытом виде
- Используйте переменные окружения для хранения токена
- Регулярно проверяйте логи доступа к API
- При подозрении компрометации немедленно замените токен
Лимит запросов
Установлен лимит на количество запросов для обеспечения стабильной работы API
Основное ограничение
Неограниченное количество запросов для всех тарифов.
API доступен 24/7 для обеспечения бесперебойной работы.
Последствия превышения лимита
| Тип нарушения | Мера воздействия | Длительность | Статус |
|---|---|---|---|
| Первое превышение | Рейт-лимит | 5 минут | Временно |
| Повторные нарушения | Блокировка | 24 часа | Блокировка |
| Систематические нарушения | Длительная блокировка | Постоянно | Перманентно |
Рейт-лимит
API работает без ограничений для всех тарифов.
Систематические нарушения
При частых нарушениях правил использования API применяются дополнительные меры
Процедура предупреждений
- Первое серьёзное нарушение: выдается предупреждение
- Повторные нарушения: выдаются дополнительные предупреждения
- Множественные нарушения: полная блокировка доступа к API
Что считается систематическим нарушением
- Регулярное превышение лимитов запросов
- Попытки обхода системы аутентификации
- Использование API для незаконных целей
- Создание множества аккаунтов для обхода ограничений
- Действия, нарушающие работу сервиса
Рекомендации
Для комфортной работы с API рекомендуем соблюдать следующие правила
Оптимизация запросов
- Добавляйте задержки между запросами при массовых операциях
- Кэшируйте результаты повторяющихся запросов
- Используйте обработку ошибок и повторные попытки
- Следите за лимитами использования через заголовки ответа
Управление доступом
- Своевременно обновляйте IP-адреса при их изменении
- Используйте разные токены для разных проектов
- Регулярно проверяйте статистику использования API
- Следите за новостями и обновлениями сервиса
Технические рекомендации
- Используйте HTTPS для всех запросов
- Реализуйте корректную обработку HTTP кодов ошибок
- Добавьте логирование запросов и ответов
- Используйте таймауты для предотвращения зависания
Поддержка
При возникновении вопросов или необходимости увеличения лимитов
Связь с технической поддержкой
При возникновении вопросов или необходимости увеличения лимитов обращайтесь в техническую поддержку следующими способами:
- Техническая поддержка: доступна 24/7 для всех клиентов
- Запрос на увеличение лимитов: рассматривается индивидуально
- Вопросы по интеграции: помощь с настройкой и кодом
- Сообщить о проблеме: оперативное решение технических вопросов