Dokumentace

Odeslání jedné adresy URL


Chcete-li adresu URL odeslat pomocí požadavku HTTP ( nahraďte adresou URL uvedenou ve vyhledávači), vydejte svůj požadavek na následující adresu URL:

                https://<searchengine>/indexnow?url=url-changed&key=your-key
            
  • url-changed je adresa URL vaší webové stránky, která byla přidána, aktualizována nebo odstraněna. Adresa URL musí být uvedena znakem „escape“ a kódována. Ujistěte se, že vaše adresy URL splňují standard RFC-3986 pro identifikátory URI.
  • Your-key by měl obsahovat minimálně 8 a maximálně 128 šestnáctkových znaků. Klíč může obsahovat jen následující znaky: malá písmena (a–z), velká písmena (A–Z), číslice (0–9) a pomlčky (-).

Například pokud chcete vyhledávače informovat, že stránka https://www.example.com/product.html byla aktualizována a chcete použít tento klíč , vaše adresa URL bude následující:

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

Požadavek HTTP můžete vydat pomocí vašeho prohlížeče, wget, curl nebo jakéhokoli jiného mechanismu, který si vyberete. Úspěšný požadavek vrátí kód odpovědi HTTP 200. Pokud obdržíte jinou odpověď, ověřte, že neodesíláte požadavky příliš často a že klíč a adresa URL jsou platné, a poté požadavek odešlete znovu. Kód odpovědi HTTP 200 pouze značí, že vyhledávač obdržel vaši adresu URL.

Odeslání sady adres URL


Chcete-li odeslat sadu adres URL pomocí požadavku HTTP, vydejte požadavek POST JSON na adresu URL uvedenou ve vyhledávačích. nahraďte názvem hostitele vyhledávače.

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

V jednom příspěvku můžete odeslat až 10 000 adres URL a v případě potřeby můžete kombinovat adresy URL http a https.

Požadavek HTTP můžete vydat pomocí wget, curl nebo jiného mechanismu, který si vyberete. Úspěšný požadavek vrátí kód odpovědi HTTP 200. Pokud jste obdrželi jinou odpověď, měli byste požadavek ověřit. Pokud všechno vypadá v pořádku, odešlete požadavek znovu. Kód odpovědi HTTP 200 pouze značí, že vyhledávač obdržel vaši sadu adres URL.

Doporučujeme zautomatizovat odesílání adres URL ihned, když jsou přidány, aktualizovány nebo odstraněny, až do určitého limitu. Projděte si osvědčené postupy týkající se uživatelem generovaného obsahu v Častých dotazech.

Ověření vlastnictví prostřednictvím klíče


Chcete-li odeslat adresy URL, musíte „prokázat“ vlastnictví hostitele, pro kterého adresy URL odesíláte, a to hostováním alespoň jednoho textového souboru na daném hostiteli. Po odeslání adres URL do vyhledávačů vyhledávače projdou soubor klíče, aby ověřily vlastnictví. Klíč bude používán, dokud ho nezměníte. Klíč a umístění souboru klíče byste měli znát pouze vy a vyhledávače.

Poskytujeme dva způsoby ověření vlastnictví.

Možnost 1
Hostování textového souboru klíče v kořenovém adresáři hostitele

Musíte hostovat textový soubor klíče s kódováním UTF-8 {your-key}.txt, který obsahuje klíč v souboru v kořenovém adresáři vaší webové stránky.

Například pro předchozí příklady budete muset hostovat soubor klíče UTF-8 na adrese https://www.example.com/.txt a tento soubor musí obsahovat klíč .

Možnost 2
Hostování textového souboru klíče na hostiteli

Můžete hostovat jeden až několik textových souborů klíče s kódováním UTF-8 v různých umístěních na stejném hostiteli a vyhledávačům musíte sdělit umístění tohoto textového souboru klíče v každém oznámení IndexNow, a to tak, že umístění zadáte pomocí proměnné keyLocation.

Pokud odesíláte jednu adresu URL, zadejte umístění souboru klíče jako hodnotu parametru keyLocation adres URL.

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

Pokud odesíláte sadu adres URL, zadejte umístění souboru klíče jako proměnnou keyLocation v obsahu 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"
                          ]
                    }
                

V této druhé možnosti umístění souboru klíče určuje sadu adres URL, které lze s tímto klíčem zahrnout. Soubor klíče umístění na adrese http://example.com/catalog/key12457EDd.txt může zahrnovat jakékoli adresy URL začínající na http://example.com/catalog/, ale nemůže zahrnovat adresy URL začínající na http://example.com/help/.

Adresy URL, které nejsou v souboru http://example.com/catalog/sitemap.xml považovány za platné:

Adresy URL, které nejsou považovány za platné ve druhé možnosti, nemusí být vhodné pro indexování. Důrazně doporučujeme, abyste použili první možnost a umístili soubor klíče do kořenového adresáře vašeho webového serveru.

Response format


HTTP Code
Response
Reasons
200
OK
URL submitted successfully
202
Accepted
URL received. IndexNow key validation pending.
400
Bad request
Invalid format
403
Forbidden
In case of key not valid (e.g. key not found, file found but key not in the file)
422
Unprocessable Entity
In case of URLs which don’t belong to the host or the key is not matching the schema in the protocol
429
Too Many Requests
Too Many Requests (potential Spam)

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 or be closely linked to the search market and make a significant contribution to the number of url submissions. Learn more