Dokumentatsioon
Ühe URL-i esitamine
URL-i esitamiseks HTTP-päringu abil (asendage
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
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
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.
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/
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
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