API Linkovod.ru
HTTP API Linkovod.ru позволяет управлять проектами и заданиями на размещение ссылок напрямую из вашей системы. Подходит для интеграции с внутренними сервисами и автоматизации.
Эндпоинты API
Коды ответов сервера
Общая информация
При использовании API/MCP вы самостоятельно управляете размещением ссылок, без участия нашего алгоритма. Вы сами выбираете поисковые запросы, типы ссылок, скорость размещения и ссылочную стратегию.
Все запросы к API требуют авторизации через API-ключ, который передается в заголовке
Authorization: Bearer <API_KEY>.Также обязательно передавать заголовок
Content-Type: application/json.Базовый URL API:
https://linkovod.ru/apiЛимиты запросов
- Рекомендуем делать не более 30 запросов в секунду.
- Запросы следует выполнять последовательно, дожидаясь ответа от сервера перед следующим вызовом.
- При частых нарушениях лимитов возможна временная блокировка API-ключа и IP-адреса.
Создание задания на размещение ссылки
- Перед созданием заданий на ссылки необходимо один раз создать проект с указанием параметров адреса сайта.
- Для каждого нового задания на ссылку необходимо передавать ID проекта.
- Домен сайта в задании на ссылку должен совпадать с доменом в проекте.
- Можно создавать любое количество заданий на размещение ссылок.
- ID задания на ссылку и ID проекта следует сохранить в вашей системе для дальнейшего управления (проверка статуса, отклонение, изменение лимитов цен проекта).
- Сайты-доноры отбираются для выполнения каждого задания нами индивидуально и проверяются на минимальные требования, предварительно выбрать их нельзя.
Отслеживание статуса
- Рекомендуется проверять статус задания на ссылку не чаще 1 раза в сутки.
- Время выполнения зависит от спроса и сложности задания на ссылку: от нескольких часов до нескольких дней.
Гарантия и мониторинг
- Каждое задание на ссылку проверяется модераторами на соответствие всем требованиям сервиса.
- Наличие ссылки проверяется регулярно в течение 30 дней (гарантийный срок).
- Если ссылка будет удалена в этот период, она будет заменена на аналогичную.
- Рекомендуется синхронизировать статусы заданий и адреса ссылок раз в сутки для получения актуальных данных.
Управление заданиями
- Можно отклонить выполненную работу в течение 30 дней (но только по уважительной причине, например, недостоверная информация или неработающая ссылка).
- Можно удалить задание на ссылку, если оно больше не актуально (только до перехода задания из статуса NEW в любой другой статус).