Dokumentáció

Egy URL-cím megadása

Egy URL-cím HTTP-kéréssel való megadásához („”: ezt helyettesítse a keresőmotor által megadott URL-címmel) a következő URL-címet használja a kérés kiadásához:

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

• az „url-changed” (módosított URL) helyére a webhely újonnan hozzáadott, frissített vagy törölt URL-címe kerül. Az URL-címet escape karakterrel kell jelölni és kódolni, és meg kell felelnie az URI-kra vonatkozó RFC-3986 szabványnak.
• A „your key” (saját-kulcs) legalább 8 és legfeljebb 128 hexadecimális karakterből állhat. A kulcs csak a következő karaktereket tartalmazhatja: kisbetűk (a–z), nagybetűk (A–Z), számok (0–9) és kötőjelek (-).

Ha például azt szeretné tudatni a keresőmotorokkal, hogy a https://www.example.com/product.html oldalt frissítette, és a kulcsa ez: , akkor az URL-cím a következő lesz:

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

A HTTP-kérést elküldheti a böngészője, Wget, cURL vagy bármilyen egyéb mechanizmus használatával. Sikeres kérés esetén a rendszer HTTP 200 válaszkódot ad vissza; ha ettől eltérő választ kap, ellenőrizze, hogy nem indít-e túl gyakran kérést, és hogy a kulcs és az URL-cím érvényes-e, majd küldje el újra a kérést. A HTTP 200 válaszkód csak azt jelzi, hogy a keresőmotor megkapta az URL-címet.

Több URL-cím elküldése

Ha több URL-címet szeretne egy HTTP-kérésen belül elküldeni, indítsa el a POST JSON-kérést a keresőmotor által megadott URL-címre. „”: ezt helyettesítse a keresőmotor gazdagépnevével.

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

Bejegyzésenként legfeljebb 10 000 URL-címet küldhet el, amelyek között szükség szerint szerepelhetnek http és https URL-ek is.

A HTTP-kérést elküldheti a Wget, cURL vagy egyéb mechanizmus használatával. Sikeres kérés esetén a rendszer HTTP 200 válaszkódot ad vissza; ha ettől eltérő választ kap, ellenőrizze a kérését, és ha minden jónak tűnik, küldje el újra a kérést. A HTTP 200 válaszkód csak azt jelzi, hogy a keresőmotor megkapta az URL-címeket.

Az ajánlott eljárás az URL-címek azonnali automatikus elküldése a tartalom hozzáadása, frissítése vagy törlése után bizonyos korlátokkal; lásd a felhasználók által létrehozott tartalommal kapcsolatos ajánlott eljárásokat a gyakori kérdések között.

A webhely tulajdonjogának igazolása a kulccsal

URL-címek elküldéséhez „bizonyítania” kell, hogy az Ön tulajdonában áll a gazdagép, amelynek az URL-címeit elküldi. Ezt úgy teheti meg, hogy legalább egy szövegfájlt elhelyez a gazdagépen belül. Amint elküldi az URL-címeket a keresőmotoroknak, azok bejárják a kulcsfájlt, hogy ellenőrizzék a tulajdonjogot, és addig használják a kulcsot, amíg Ön nem módosítja. Csak Ön és a keresőmotorok ismerhetik a kulcsot és a kulcsfájl helyét.

Két módot kínálunk a tulajdonjog igazolására.

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