Аутентификация API push в Baidu не удается, если токен сайта, URL сайта или права пользователя не совпадают с учетными данными, сохраненными в Baidu Search Resource Platform. Этот процесс требует специального ключа API, созданного в панели пользователя, для авторизации отправки новых или обновленных URL непосредственно в индекс. Успешная аутентификация гарантирует, что поисковая система получает обновления вашего контента в реальном времени, что помогает поддерживать видимость, не дожидаясь стандартного цикла сканирования.
Что вызывает ошибки аутентификации API push в Baidu?
Большинство сбоев аутентификации связаны с несоответствием между зарегистрированным доменом и URL, используемым в запросе API. В Baidu Search Resource Platform каждому ресурсу присваивается уникальный токен, который строго привязан к этому конкретному домену. Если вы попытаетесь использовать токен из среды тестирования (staging) на рабочем сайте, сервер вернет ошибку 401 Unauthorized. Это происходит потому, что система проверяет параметр сайта по токену, чтобы предотвратить несанкционированную отправку URL с доменов третьих лиц.
Другая распространенная причина связана с протоколом, используемым в процессе верификации. Если сайт был верифицирован по протоколу HTTP, но запрос API выполняется с использованием URL HTTPS в параметре сайта, проверка аутентификации часто не проходит. Платформа рассматривает их как разные сущности, если они не объединены должным образом в рамках учетной записи. Кроме того, истекшие токены после миграции учетной записи или сброса безопасности приведут к немедленному разрыву соединения. Проверка текущего статуса вашего сайта в разделе Resource Submission — это первый шаг к диагностике этих сбоев.
Успешная отправка через API зависит от точного совпадения протокола и строки домена. Если ваш сайт верифицирован как HTTP, но вы отправляете URL HTTPS, система часто отклоняет запрос аутентификации.
SEO-команда Alien Road
Почему сервер отклоняет токен сайта?
Токен сайта выступает в качестве основного уровня безопасности для сервиса push в Baidu. Когда сервер отклоняет токен, это обычно происходит из-за того, что токен был перегенерирован или изменился владелец сайта. Пользователи часто обновляют свои ключи по соображениям безопасности, но забывают обновить конфигурацию в своей системе управления контентом или пользовательских скриптах. Это приводит к ситуации, когда автоматизация продолжает отправлять запросы с использованием недействительных учетных данных, что в конечном итоге приводит к временной блокировке за чрезмерное количество неудачных попыток.
- Войдите в Baidu Search Resource Platform и перейдите в меню ‘Link Submission’.
- Выберите вкладку ‘API Push’, чтобы просмотреть ваш текущий токен, специфичный для сайта.
- Сравните токен на панели с тем, который используется в вашей конфигурации на стороне сервера.
- Проверьте, точно ли URL сайта в вашем коде совпадает с доменом, как он указан в списке платформы.
- Убедитесь, что учетная запись пользователя, связанная с токеном, по-прежнему имеет права администратора для этого ресурса.
Как структурировать запрос API для Baidu?
API требует POST-запрос к определенной конечной точке, который включает как домен вашего сайта, так и секретный токен в качестве параметров запроса. Тело запроса должно быть обычным текстом, содержащим по одному URL в строке. Распространенной ошибкой является отправка данных в виде объекта JSON или списка, разделенного запятыми, который сервер Baidu не сможет правильно проанализировать. Это приводит к ошибке 400 Bad Request, которую можно спутать с проблемой аутентификации, если журналы ошибок недостаточно подробны.
Например, типичная конечная точка выглядит как URL, начинающийся с data.zz.baidu.com, за которым следуют параметры сайта и токена. При отправке запроса убедитесь, что заголовок Content-Type установлен на text/plain. Если вы отправляете URL для определенного поддомена, этот поддомен должен быть верифицирован независимо в Search Resource Platform, чтобы получить свой собственный уникальный токен. Попытка отправки URL поддомена с использованием токена корневого домена является частой причиной отклонения аутентификации.
Каковы распространенные коды ошибок в ответе API?
Понимание числового ответа от сервера Baidu является ключом к быстрому восстановлению. Система предоставляет конкретные коды, которые указывают, заключается ли проблема в учетных данных, формате данных или суточных лимитах. Мониторинг этих кодов позволяет автоматизировать обработку ошибок в ваших SEO-инструментах.
- Ошибка 401: Указывает на сбой аутентификации, обычно из-за неверного или истекшего токена.
- Ошибка 400: Часто означает, что тело запроса пустое или формат URL неверен.
- Ошибка 404: Указывает на то, что URL конечной точки введен неправильно или сервис временно недоступен.
- Ошибка 411: Возникает, когда в POST-запросе отсутствует заголовок Content-Length.
- Ошибка 200: Код успеха, обычно возвращающий тело JSON с количеством успешно отправленных URL и оставшейся суточной квотой.
Автоматизация процесса отправки сокращает время, необходимое для появления нового контента в результатах поиска, что является ключевым фактором для новостных и e-commerce сайтов, работающих на конкурентных рынках.
SEO-команда Alien Road
Как Alien Road применяет аутентификацию API push в Baidu
Alien Road применяет аутентификацию API push в Baidu, сначала проводя технический аудит текущего статуса верификации сайта клиента. Мы проверяем, правильно ли сайт зарегистрирован в интерфейсе платформы. Для типичного розничного клиента мы внедряем пользовательский скрипт, который фиксирует каждое событие создания нового URL. Этот скрипт форматирует список URL в тело обычного текста и отправляет его на конечную точку Baidu, используя токен, специфичный для сайта.
Мы ежедневно отслеживаем ошибки ‘over_quota’ и ‘not_same_site’, чтобы корректировать частоту этих обновлений. Например, если клиент с большим каталогом видит пробелы в индексации, мы проверяем статус токена и убеждаемся, что ответ сервера остается стабильным. Этот систематический подход гарантирует, что индекс поисковой системы отражает актуальную архитектуру сайта без ручного вмешательства, обеспечивая надежный путь для обнаружения контента.
С чего начать на этой неделе
Начните с входа в свою учетную запись Baidu Search Resource Platform и перехода в раздел ‘Link Submission’ в ‘Resource Submission’. Скопируйте свой уникальный токен и выполните ручной тест с помощью инструмента, такого как cURL или локальный скрипт, чтобы увидеть, может ли ваш сервер подключиться к конечной точке Baidu. Если вы получили код успеха 200, вы можете начать процесс автоматизации этих отправлений в рамках вашей CMS. Если вы получили ошибку 401, дважды проверьте протокол вашего сайта и убедитесь, что токен точно совпадает с доменом.