Документация

Отправка одного URL-адреса

Чтобы отправить URL-адрес с помощью HTTP-запроса (замените URL-адресом, предоставленным поисковой системой), отправьте запрос по следующему URL-адресу:

                https://<searchengine>/indexnow?url=url-changed&key=your-key
            

• url-changed — это URL-адрес вашего веб-сайта, который был добавлен, обновлен или удален. URL-адрес должен быть экранирован и закодирован, и убедитесь, что ваши URL-адреса соответствуют стандарту RFC-3986 для URL-адресов.
• Ваш ключ должен содержать от 8 до 128 шестнадцатеричных символов. Ключ может содержать только следующие символы: строчные (a-z), прописные (A-Z), цифры (0-9) и тире (-).

Например, если вы хотите уведомить поисковые системы об обновлении https://www.example.com/product.html и хотите использовать этот ключ , ваш URL-адрес будет таким:

                https://<searchengine>/indexnow?url=https://www.example.com/product.html&key=
            

Вы можете отправить HTTP-запрос, используя свой браузер, wget, curl или любой другой механизм по вашему выбору. Успешный запрос вернет код ответа «HTTP 200». Если вы получили другой ответ, проверьте, что вы не отправляете запрос слишком часто, что ключ и URL-адрес действительны, и повторно отправьте запрос. Код ответа «HTTP 200» означает только то, что поисковая система получила ваш URL.

Отправка набора URL-адресов

Чтобы отправить набор URL-адресов с помощью HTTP-запроса, отправьте запрос POST JSON на URL-адрес, предоставленный поисковыми системами. Замените именем хоста поисковой системы.

                POST /indexnow HTTP/1.1
                Content-Type: application/json; charset=utf-8
                Host: <searchengine>
                {
                  "host": "www.example.com",
                  "key": "",
                  "urlList": [
                      "https://www.example.com/url1",
                      "https://www.example.com/folder/url2",
                      "https://www.example.com/url3"
                      ]
                }
            

Вы можете отправить до 10 000 URL-адресов в одном сообщении, при необходимости смешивая URL-адреса http и https.

Вы можете отправить HTTP-запрос, используя wget, curl или любой другой механизм по вашему выбору. Успешный запрос вернет код ответа «HTTP 200». Если вы получили другой ответ, проверьте свой запрос и, если все в порядке, отправьте его повторно. Код ответа «HTTP 200» означает только то, что поисковая система получила ваш набор URL-адресов.

Рекомендуется автоматизировать отправку URL-адресов, как только содержимое добавляется, обновляется или удаляется до определенного предела; см. лучшие методы работы с пользовательским содержимым в разделе «Вопросы и ответы».

Проверка права собственности с помощью ключа

Чтобы отправить URL-адреса, вы должны «подтвердить» право собственности на хост, для которого отправляются URL-адреса, разместив на этом хосте хотя бы один текстовый файл. После того, как вы отправите свои URL-адреса в поисковые системы, они будут выполнять обход содержимого файла ключа для проверки права собственности и использовать этот ключ до тех пор, пока вы его не смените. Только вы и поисковые системы должны знать ключ и местонахождение вашего файла ключа.

Мы предлагаем два способа проверки права собственности.

                    https://<searchengine>/indexnow?url=http://www.example.com/product.html&key=&keyLocation=http://www.example.com/myIndexNowKey63638.txt
                

                    POST /indexnow HTTP/1.1
                    Content-Type: application/json; charset=utf-8
                    Host: <searchengine>
                    {
                      "host": "www.example.com",
                      "key": "",
                      "keyLocation": "https://www.example.com/myIndexNowKey63638.txt",
                      "urlList": [
                          "https://www.example.com/url1",
                          "https://www.example.com/folder/url2",
                          "https://www.example.com/url3"
                          ]
                    }