Dokumentacja

Przesyłanie pojedynczego adresu URL

Aby przesłać adres URL za pomocą żądania HTTP, zastąp adresem URL dla danej wyszukiwarki i wyślij żądanie na następujący adres:

                https://<searchengine>/indexnow?url=zmieniony-url&key=twój-klucz
            

• Zastąp wartość „zmieniony-url” adresem URL Twojej witryny, który został dodany, zaktualizowany lub usunięty. Adres URL musi być zakodowany i zgodny ze standardem RFC-3986 dotyczącym identyfikatorów URI.
• Wartość „twój-klucz” powinna zawierać co najmniej 8, ale nie więcej niż 128 znaków szesnastkowych. Klucz może zawierać tylko następujące znaki: małe litery (a-z), wielkie litery (A-Z), cyfry (0-9) i łączniki (-).

Na przykład jeśli chcesz powiadomić wyszukiwarki, że został zaktualizowany adres https://www.example.com/product.html, i chcesz użyć klucza , adres URL będzie wyglądał następująco:

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

Możesz wysłać żądanie HTTP za pomocą przeglądarki internetowej, wget, curl lub dowolnego innego wybranego przez siebie mechanizmu. W odpowiedzi na pomyślne przesłanie żądania otrzymasz kod HTTP 200. W przypadku innej odpowiedzi sprawdź, czy nie przesyłasz żądań zbyt często oraz czy klucz i adres URL są prawidłowe. Następnie prześlij żądanie ponownie. Kod odpowiedzi HTTP 200 wskazuje tylko, że wyszukiwarka otrzymała od Ciebie adres URL.

Przesyłanie zestawu adresów URL

Aby przesłać zestaw adresów URL za pomocą żądania HTTP, wyślij żądanie POST w formacie JSON na adresy URL poszczególnych wyszukiwarek. Zastąp nazwą hosta wyszukiwarki.

                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"
                      ]
                }
            

Pojedyncze żądanie POST może zawierać do 10 000 adresów URL. Dozwolone jest mieszanie adresów URL z przedrostkami http i https.

Możesz wysłać żądanie HTTP za pomocą wget, curl lub innego wybranego przez siebie mechanizmu. W odpowiedzi na pomyślne przesłanie żądania otrzymasz kod HTTP 200. W przypadku innej odpowiedzi sprawdź treść żądania. Jeśli wygląda prawidłowo, prześlij je ponownie. Kod odpowiedzi HTTP 200 wskazuje tylko, że wyszukiwarka otrzymała Twój zestaw adresów URL.

Zalecamy, aby zautomatyzować przesyłanie adresów URL w momencie dodania, aktualizacji lub usunięcia treści – do pewnego limitu. W sekcji Często zadawane pytania możesz zapoznać się ze sprawdzonymi metodami dotyczącymi treści generowanych przez użytkowników.

Weryfikacja własności hosta za pomocą klucza

Aby przesłać adresy URL, musisz udowodnić, że jesteś właścicielem hosta przesyłanych adresów URL. Możesz to zrobić, umieszczając na hoście co najmniej jeden plik tekstowy. Gdy prześlesz adresy URL do wyszukiwarek, zindeksują one plik z kluczem w celu weryfikacji własności hosta i będą używać tego klucza, dopóki go nie zmienisz. Tylko Ty i wyszukiwarki powinniście znać klucz i lokalizację pliku z kluczem.

Oferujemy dwa sposoby weryfikacji własności.

                    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"
                          ]
                    }