Fylgiskjöl

Ein vefslóð send


Þegar senda á vefslóð með HTTP-beiðni ( skipt út með vefslóðinni sem leitarvélin leggur til) skal senda beiðnina á eftirfarandi vefslóð:

                https://<searchengine>/indexnow?url=url-changed&key=your-key
            
  • url-changed er vefslóð vefsvæðis þíns sem hefur verið bætt við, uppfærð eða eytt. Vefslóð þarf að vera URL-escaped og kóðuð, auk þess sem tryggja þarf að vefslóðir uppfylli staðalinn RFC-3986 fyrir URI.
  • Your-key ætti að vera minnst 8 og mest 128 sextándakerfisstafir. Lykilinn getur innihaldið eftirfarandi stafi: lágstafi (a-z), hástafi (A-Z), tölustafi (0-9) og bandstrik (-).

Viljir þú t.d. tilkynna leitarvélum að https://www.example.com/product.html hafi verið uppfærð og þú viljir nota þennan lykil er vefslóðin þín:

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

Hægt er að senda HTTP-beiðni með vafra, wget, curl eða öðrum leiðum. Vel heppnuð beiðni skilar HTTP 200-svarkóða; ef annað svar berst þarftu að ganga úr skugga um þú hafir ekki sent of oft og að lykillinn og vefslóðin séu gild. Að því loknu þarftu að senda beiðnina aftur. HTTP 200-svarkóðinn gefur eingöngu til kynna að leitarvélin hafi móttekið vefslóðina þína.

Margar vefslóðir sendar


Þegar senda á margar vefslóðir með HTTP-beiðni þarftu að senda POST JSON-beiðnina á vefslóðina sem leitarvélar leggja fram. Skiptu út fyrir hýsilheiti leitarvélarinnar.

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

Þú getur sent allt að 10.000 vefslóðir í hverri sendingu, þar sem blandað er saman http- og https-vefslóðum, ef með þarf.

Hægt er að senda HTTP-beiðni með wget, curl eða öðrum leiðum. Vel heppnuð beiðni skilar HTTP 200-svarkóða; ef annað svar berst þarftu að fara yfir beiðnina þína og senda aftur ef allt lítur eðlilega út. HTTP 200-svarkóðinn gefur eingöngu til kynna að leitarvélin hafi móttekið vefslóðirnar þínar.

Mælt er með að sending vefslóða sé sjálfvirk, upp að því marki sem það er mögulegt, þegar nýju efni er bætt við, það uppfært eða því eytt. Frekari upplýsingar er að finna í umfjöllun um bestu starfsvenjur fyrir efni notanda í algengum spurningum.

Eignarhald staðfest með lykli


Þegar vefslóðir eru sendar þarf að „sanna“ eignarhald hýsilsins sem sendir vefslóðirnar með því að hýsa minnst eina textaskrá hjá hýslinum. Um leið og vefslóðir eru sendar til leitarvéla skríða leitarvélarnar lykilskrána til að staðfesta eignarhald og nota svo lykilinn þar til honum er skipt út. Eingöngu þú og leitarvélarnar eigið að vita hver lykillinn er og hvar lykilskráin er staðsett.

Við bjóðum upp á tvenns konar staðfestingu á eignarhaldi.

Valkostur 1
Textalykilskrá er geymd í rótarmöppu hýsilsins.

Þú þarft að hýsa UTF-8 kóðaða lykilskrá {your-key}.txt þar sem er að finna upplýsingar um lykilinn í skránni í rótarmöppu vefsvæðis þíns.

Í dæmunum hér á undan þarftu til dæmis að hýsa UTF-8 lykilskrána á https://www.example.com/.txt og þessi skrá þarf að innihalda lykilinn

Valkostur 2
Textalykilskrá er geymd hjá hýslinum.

Þú getur hýst eina eða margar UTF-8 kóðaðar textalykilskrár á öðrum stöðum innan sama hýsils og þú þarft að upplýsa leitarvélar um staðsetningu þessara textalykilskráa í hverri einustu IndexNow-tilkynningu með því að tilgreina staðsetningu keyLocation-breytunnar.

Ef þú sendir vefslóð skaltu tilgreina staðsetningu lykilskrárinnar sem gildi keyLocation-vefslóðarfæribreytu.

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

Ef þú sendir margar vefslóðir skaltu tilgreina staðsetningu lykilskrár sem keyLocation-breytu í JSON-efninu.

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

Í valkosti 2 afmarkar staðsetning lykilskrárinnar vefslóðirnar sem hægt er að hafa með þessum lykli. Lykilskrá á http://example.com/catalog/key12457EDd.txt getur innihaldið allar vefslóðir sem byrja á http://example.com/catalog/, en ekki skrár sem byrja á http://example.com/help/.

Vefslóðir sem ekki eru taldar gildar í http://example.com/catalog/sitemap.xml eru meðal annars:

Vefslóðir sem ekki eru taldar gildar í valkosti 2 eru hugsanlega ekki teknar með í lyklun. Sérstaklega er mælt með að valkostur 1 sé notaður og lykilskráin sé sett í rótarmöppu vefþjónsins.

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