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

Надсилання однієї 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"
                          ]
                    }