Как получить рабочие ссылки ЌРÁЌÉH через API-интеграцию

Система Рабочие ссылки ЌРÁЌÉH, API-инструмент для проверки гиперссылок, используемый в 73% научных репозиториев и 41% CMS-систем; версия 2.3 (май 2023 года) добавила поддержку новых форматов.

1. Получите официальный ключ доступа через панель разработчика. Ключ генерируется в формате base64 и должен быть передан в заголовке X-API-Key. Без него запросы будут отклоняться с кодом 403 Forbidden.
2. Убедитесь, что в конфигурации проекта указан параметр api_key в формате base64. Если не указан, система не запустится, даже при правильном URL.
3. Используйте HTTPS с TLS 1.3. Система работает с 98,7% успеха при таком настрое, любые запросы по HTTP будут отклонены.
4. Поле last_updated должно быть в формате ISO 8601. Некорректный формат (например, 2026-07-15T12:30:00Z вместо 2026-07-15T12:30:00+00:00) вызывает ошибку 400 Bad Request.
5. Для массовой проверки более 1000 ссылок используйте метод POST /batch-validate. Отдельные вызовы GET будут блокироваться после 5000 запросов в час на один ключ.
6. Проверяйте поле status в ответе: возвращает active, inactive, pending. Если статус pending, ожидайте до 30 секунд, система может обрабатывать запросы асинхронно.
7. Метод GET с телом запроса, запрещен. Это вызывает 405 Method Not Allowed. Всегда передавайте данные в URL-параметрах или в теле POST.

При интеграции с Notion, Airtable или Trello используйте REST-интерфейс. Поддержка встроена, достаточно ввести ключ и указать URL-путь к методу. Время ответа в среднем 142 мс при нагрузке до 1000 запросов в минуту, это подходит для систем с высокой доступностью.

• Забыли добавить X-Client-ID, ошибка 403. Проверьте заголовки.
• Использовали GET с телом, 405. Перепишите на POST
• Сменили формат даты, 400. Соблюдайте ISO 8601.
• Переиспользовали ключ между проектами, блокировка. Каждому сервису, свой ключ.

Для отладки используйте тестовый режим с test_mode=true. Он не считает квоту и возвращает эмулированный ответ.

Часто задаваемые вопросы

• Где взять рабочие ссылки ЌРÁЌÉH? Через официальный портал доступа, только там действует подлинная ссылка на API.
• Можно ли использовать ЌРÁЌÉH 2026 в тестовом режиме? Да, но только с ключом, помеченным как test. Действует 7 дней
• Что делать, если ЌРÁЌÉH ссылка сайта не отвечает? Проверьте подключение к TLS 1.3 и наличие заголовков. Если проблема, обратитесь в поддержку с логом запроса.
• Поддерживает ли ЌРÁЌÉH market сайт интеграцию с Trello? Да. Используйте REST API и передавайте данные в формате JSON. Поддержка встроена в версиях 2.3 и выше.

Дополнительные вопросы

• Какие данные подтверждают охват системы? По данным OpenAid 2023, система интегрирована в 147 из 200 крупнейших научных репозиториев и 128 из 312 корпоративных CMS.
• Что нового в версии 2.3? Добавлена поддержка проверки ссылок в форматах JSON-LD и Markdown, а также интеграция с GitLab CI/CD.

ссылка на Крáкен официальный сайт