Dokumentacija

Slanje jednog URL-a

Da biste poslali URL pomoću HTTP zahtjeva (zamijenite URL-om koji vam je pružila tražilica), pošaljite zahtjev na sljedeći URL:

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

• url-promijenjen je URL vašeg web-mjesta koji je dodan, ažuriran ili izbrisan. URL mora biti u obliku URL-prespojni znak i mora biti šifriran. Također, pobrinite se da vaši URL-ovi slijede standard RFC-3986 za URI-je.
• Vaš ključ mora sadržavati minimalno 8 i maksimalno 128 heksadecimalnih znakova. Ključ smije sadržavati samo sljedeće znakove: mala slova (a – z), velika slova (A – Z), brojeve (0 – 9) i spojnice (-).

Na primjer, ako želite obavijestiti tražilicu da je URL https://www.example.com/product.html ažuriran i želite upotrijebiti ključ , vaš će URL biti sljedeći:

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

Za slanje HTTP zahtjeva možete upotrijebiti preglednik, Wget, cURL ili bilo koji drugi način koji odaberete. Uspješan zahtjev vratit će kod odgovora HTTP 200. Ako primite drukčiji odgovor, provjerite jeste li prečesto slali zahtjeve, jesu li ključ i URL valjani pa ponovno pošaljite zahtjev. Kod odgovora HTTP 200 samo označava da je tražilica primila vaš URL.

Slanje niza URL-ova

Da biste poslali niz URL-ova putem HTTP zahtjeva, pošaljite zahtjev POST JSON na URL koji vam je pružila tražilica. Zamijenite nazivom glavnog računala tražilice.

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

Možete poslati najviše 10.000 URL-ova po objavi, kombinirajući HTTP i HTTPS URL-ove ako je potrebno.

Za slanje HTTP zahtjeva možete upotrijebiti Wget, cURL ili neki drugi način koji odaberete. Uspješan zahtjev vratit će kod odgovora HTTP 200. Ako dobijete drukčiji odgovor, provjerite zahtjev i ako se čini da je sve u redu, ponovno pošaljite zahtjev. Kod odgovora HTTP 200 samo označava da je tražilica primila vaš niz URL-ova.

Preporučeni način je automatizacija slanja URL-ova odmah po dodavanju, ažuriranju ili brisanju sadržaja do određenog ograničenja. Pogledajte Najčešća pitanja za najbolje prakse za korisnički generiran sadržaj.

Provjera vlasništva putem ključa

Da biste poslali URL-ove, morate „dokazati” vlasništvo nad glavnim računalom za koje se URL-ovi šalju tako da hostirate barem jednu tekstnu datoteku na glavnom računalu. Kada svoje URL-ove pošaljete tražilicama, tražilice će pretražiti tekstnu datoteku radi indeksiranja sadržaja kako bi provjerile vlasništvo i upotrebljavat će ključ sve dok ga ne promijenite. Samo vi i tražilice trebate znati ključ i lokaciju ključa datoteke.

Dostupna su dva načina za provjeru vlasništva.

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