Dokumentatsioon

Ühe URL-i esitamine


URL-i esitamiseks HTTP-päringu abil (asendage otsingumootori antud URL-iga) esitage taotlus järgmisele URL-ile:

                https://<searchengine>/indexnow?url=url-changed&key=your-key
            
  • URL-muudetud on teie veebisaidi URL, mis on lisatud, värskendatud või kustutatud. URL peab olema URL-põgenenud ja kodeeritud ning veenduge, et teie URL-id järgiksid URI-de standardit RFC-3986.
  • Teie võtmes peab olema vähemalt 8 ja maksimaalselt 128 kuueteistkümnendmärki. Võti võib sisaldada ainult järgmisi tähemärke: väiketähed (a–z), suurtähed (A–Z), numbrid (0–9) ja sidekriipsud (-).

Näiteks kui soovite otsingumootoritele teatada, et https://www.example.com/product.html on värskendatud ja soovite seda võtit kasutada, on teie URL järgmine:

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

Saate HTTP-päringu väljastada oma brauseri, wget-i, curl-i või mõne muu teie valitud mehhanismi abil. Edukas päring tagastab HTTP 200 vastusekoodi. Kui saate teistsuguse vastuse, kontrollige, kas te ei esita seda liiga sageli, kas võti ja URL on kehtivad, ja esitage taotlus uuesti. HTTP 200 vastuskood näitab ainult seda, et otsingumootor on teie URL-i kätte saanud.

URL-ide komplekti esitamine


HTTP-päringu abil URL-ide komplekti saatmiseks edastage oma POST JSON-i päring otsingumootorite esitatud URL-ile. Asendage otsingumootori hosti nimega.

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

Saate postituse kohta esitada kuni 10 000 URL-i, vajadusel segades http ja https URL-id.

Saate HTTP-päringu väljastada wget-i, curl-i või mõne muu teie valitud mehhanismi abil. Edukas päring tagastab HTTP 200 vastusekoodi. Kui saate teistsuguse vastuse, peaksite oma taotluse kinnitama ja kui kõik tundub korras olevat, esitage oma taotlus uuesti. HTTP 200 vastuskood näitab ainult seda, et otsingumootor on teie URL-ide komplekti kätte saanud.

Soovitatav viis on automatiseerida URL-ide esitamine kohe, kui sisu on lisatud, värskendatud või kustutatud teatud piirini. Vaadake kasutajate loodud sisu parimaid tavasid korduma kippuvates küsimustes.

Omandiõiguse kinnitamine võtme abil


URL-ide esitamiseks peate "tõestama" selle hosti kuuluvust, mille URL-id esitatakse, hostides vähemalt ühte tekstifaili. Kui olete URL-id otsingumootoritele esitanud, indekseerivad otsingumootorid võtmefaili omandiõiguse kinnitamiseks ja kasutavad võtit seni, kuni te võtit muudate. Ainult teie ja otsingumootorid peaksid teadma võtit ja failivõtme asukohta.

Omandiõiguse kinnitamiseks pakume kahte võimalust.

Valik 1
Teksti võtmefaili hostimine oma hosti juurkataloogis.

Peate hostima UTF-8 kodeeritud tekstivõtmefaili {your-key}.txt , milles on teie veebisaidi juurkataloogis oleva faili võti.

Näiteks eelmiste näidete puhul peate oma UTF-8 võtmefaili hostima aadressil https://www.example.com/.txt ja see fail peab sisaldama võtit

Valik 2
Teksti võtmefaili hostimine oma hosti sees.

Samuti saate hostida ühte või mitut UTF-8 kodeeritud tekstivõtmefaili sama hosti teistes asukohtades ja peate otsingumootoritele ütlema selle teksti võtmefaili asukoha igas IndexNow teatises, määrates asukoha muutuja keyLocation abil.

Kui esitate URL-i, määrake võtmefaili asukoht keyLocation URLs parameetri väärtusena.

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

Kui esitate URL-ide komplekti, määrake võtmefaili asukoht muutujaks keyLocation JSON-i sisus.

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

Valiku 2 puhul määrab võtmefaili asukoht selle võtmega kaasatavate URL-ide komplekti. Võtifail, mis asub aadressil http://example.com/catalog/key12457EDd.txt, võib sisaldada mis tahes URL-e, mis algavad http://example.com/catalog/, kuid ei tohi sisaldada URL-e, mis algavad http://example.com/help/.

URL-id, mida ei peeta saidil http://example.com/catalog/sitemap.xml kehtivateks, hõlmavad järgmist:

URL-e, mida ei peeta 2. valikus kehtivaks, ei pruugita indekseerimiseks arvesse võtta. On tungivalt soovitatav kasutada valikut 1 ja paigutada failivõti veebiserveri juurkataloogi.

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