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.

1. opcija
Hostiranje ključa datoteke u korijenskom direktoriju glavnog računala.

Morate hostirati šifriranu tekstnu datoteku ključa UTF-8 {vaš-ključ}.txt s navedenim ključem u datoteci u korijenskom direktoriju vašeg web-mjesta.

Primjer za prethodne primjere: trebate hostirati svoju datoteku ključa UTF-8 na web-mjestu https://www.example.com/.txt.txt i ta datoteka mora sadržavati ključ

2. opcija
Hostiranje tekstne datoteke ključa na glavnom računalu.

Također možete hostirati jednu ili više šifriranih tekstnih datoteka ključa UTF-8 na drugim lokacijama na istom glavnom računalu i morate obavijestiti tražilice o lokaciji te tekstne datoteke ključa u svakoj obavijesti IndexNow tako da navedete lokaciju pomoću varijable keyLocation.

Ako pošaljete URL, navedite lokaciju datoteke ključa kao vrijednost parametra URL-ova keyLocation.

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

Ako pošaljete niz URL-ova, navedite lokaciju datoteke ključa kao varijablu keyLocation u sadržaju JSON.

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

Ako odaberete 2. opciju, lokacija datoteke ključa određuje niz URL-ova koji mogu biti uključeni s tim ključem. Datoteka ključa koja se nalazi na http://example.com/catalog/key12457EDd.txt može uključivati bilo koji URL koji počinje s http://example.com/catalog/, ali ne može uključivati URL-ove koju počinju s http://example.com/help/.

URL-ovi koji se smatraju nevaljanim u datoteci http://example.com/catalog/sitemap.xml uključuju sljedeće:

URL-ovi koji se smatraju nevaljanim u 2. opciji možda se neće uzeti u obzir za indeksiranje. Svakako se preporučuje da upotrijebite 1. opciju i spremite ključ datoteke u korijenski direktorij web-poslužitelja.

Requirement for search engines


Search Engines adopting the IndexNow protocol agree that submitted URLs will be automatically shared with all other participating Search Engines. To participate, search engines must have a noticeable presence in at least one market.