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

Изпращане на единичен URL адрес

За да изпратите URL адрес чрез HTTP заявка (заменете с предоставения от търсачката URL адрес), изпратете заявката си на следния URL адрес:

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

• url-changed е добавен, актуализиран или изтрит URL адрес на уеб сайта ви. URL адресът трябва да е URL кодиран и се погрижете URL адресите ви да следват стандарта RFC-3986 за URI.
• Your-key трябва да има най-малко 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 адреса за една публикация, като при нужда можете да смесвате http и https URL адреси.

Можете да изпратите 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"
                          ]
                    }