Dokumentācija

Viena URL iesniegšana


Lai iesniegtu URL, izmantojot HTTP pieprasījumu (aizstājiet ar meklētājprogrammas norādīto URL), izsniedziet pieprasījumu ar šo URL:

                https://<searchengine>/indexnow?url=url-changed&key=your-key
            
  • mainīts-url ir jūsu vietnes URL, kas ir pievienots, atjaunināts vai dzēsts. Vietrādim URL ir jābūt ar atsoļa rakstzīmēm un kodētam, un, lūdzu, pārliecinieties, vai jūsu vietrāži URL atbilst RFC-3986 URI standartam.
  • Jūsu atslēgai ir jābūt ar vismaz 8 un ne vairāk kā 128 heksadecimālām rakstzīmēm. Atslēga var iekļaut tikai šādas rakstzīmes: rakstzīmes ar mazajiem burtiem (a-z), rakstzīmes ar lielajiem burtiem (A-Z), skaitļus (0–9) un domuzīmes (-).

Piemēram, ja vēlaties meklētājprogrammām paziņot, ka https://www.example.com/product.html vietne ir atjaunināta, un jūs vēlaties izmantot šo atslēgu , jūsu URL būs:

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

Jūs varat izsniegt HTTP pieprasījumu, izmantojot savu pārlūkprogrammu, wget, curl vai jebkuru citu jūsu izvēlētu mehānismu. Veiksmīgs pieprasījums atgriezīs HTTP 200 atbildes kodu; ja saņemat citu atbildi, pārbaudiet, vai iesniegšanu neveicat pārāk bieži, ka atslēga un URL ir derīgi, un atkārtoti iesniedziet pieprasījumu. Atbildes kods HTTP 200 norāda tikai to, ka meklētājprogramma ir saņēmusi jūsu URL.

URL kopas iesniegšana


Lai iesniegtu URL kopu, izmantojot HTTP pieprasījumu, meklētājprogrammu norādītajam URL izsniedziet savu POST JSON pieprasījumu. Aizvietojiet ar meklētājprogrammas resursdatora nosaukumu.

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

Vienā ziņā varat iesniegt līdz 10 000 URL, ja nepieciešams, sajaucot http un https URL.

Jūs varat izsniegt HTTP pieprasījumu, izmantojot wget, curl vai citu jūsu izvēlētu mehānismu. Veiksmīgs pieprasījums atgriezīs HTTP 200 atbildes kodu; ja saņemat citu atbildi, ir jāpārbauda pieprasījums un, ja viss izskatās kārtībā, atkārtoti jāiesniedz pieprasījums. Atbildes kods HTTP 200 norāda tikai to, ka meklētājprogramma ir saņēmusi jūsu URL kopu.

Ieteicams automātiski iesniegt URL, tiklīdz saturs ir pievienots, atjaunināts vai izdzēsts līdz noteiktai robežai; Bieži uzdotajos jautājumos skatiet lietotāja ģenerētā satura paraugpraksi.

Īpašumtiesību pārbaudīšana ar atslēgu


Lai iesniegtu URL, jums “jāpierāda” resursdatora īpašumtiesības, par kuru tiek iesniegti URL, resursdatorā mitinot vismaz vienu teksta failu. Pēc vietrāžu URL iesniegšanas meklētājprogrammās tās pārmeklē atslēgas failu, lai pārbaudītu īpašumtiesības un izmantotu atslēgu līdz atslēgas nomaiņai. Tikai jums un meklētājprogrammām ir jāzina atslēgas un jūsu faila atslēgas atrašanās vieta.

Mēs īpašumtiesību verificēšanai piedāvājam divus veidus.

1. opcija
Teksta atslēgas faila viesošana resursdatora saknes direktorijā.

Jāvieso UTF-8 kodēta teksta atslēgas fails {your-key}.txt, kurā norādīta faila atslēga jūsu vietnes saknes direktorijā.

Piemēram, iepriekšējiem piemēriem jums būs jāvieso jūsu UTF-8 atslēgas fails https://www.example.com/.txt un šim failam ir jāsatur atslēga

2. opcija
Teksta atslēgas faila viesošana jūsu resursdatorā.

Varat arī viesot vienu no daudzajiem UTF-8 kodētā teksta atslēgas failiem citās atrašanās vietās tajā pašā resursdatorā, un meklētājprogrammām ir jānorāda šī teksta atslēgas faila atrašanās vieta katrā IndexNow paziņojumā, norādot atrašanās vietu un izmantojot keyLocation mainīgo.

Ja iesniedzat URL, norādiet atslēgas faila atrašanās vietu kā keyLocation URL parametra vērtību.

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

Ja iesniedzat URL kopu, norādiet atslēgas faila atrašanās vietu kā keyLocation mainīgo JSON saturā.

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

Šajā 2. opcijā atslēgas faila atrašanās vieta nosaka vietrāžu URL kopu, ko var iekļaut šajā atslēgā. Atslēgas fails, kas atrodas http://example.com/catalog/key12457EDd.txt var ietvert jebkādus URL, kas sākas ar http://example.com/catalog/, bet nevar ietvert URL, kas sākas ar http://example.com/help/.

URL, kas http://example.com/catalog/sitemap.xml netiek uzskatīti par derīgiem, ietver:

Iespējams, ka indeksēšanai netiks ņemti vērā URL, kas nav atzīti par derīgiem 2. opcijā. Ir stingri ieteicams izmantot 1. opciju un novietot faila atslēgu tīmekļa servera saknes direktorijā.

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