Документација

Прослеђивање једне URL адресе

Да бисте проследили URL адресу преко HTTP захтева (замените URL адресом коју је обезбедио претраживач), издајте захтев за следећу URL адресу:

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

• Параметар url-changed је URL адреса ваше веб локације која је додата, ажурирана или избрисана. URL адреса мора имати escape маркер и мора бити кодирана и уверите се да ваше URL адресе поштују стандард RFC-3986 за URI-је.
• Ваша шифра мора да има најмање 8, а највише 128 хексадецималних знакова. Шифра може да садржи само следеће знакове: мала слова (a–z), велика слова (A–Z), бројеве (0–9) и цртице (-).

На пример, ако елите да обавестите претраживаче да је адреса https://www.example.com/product.html ажурирана и желите да користите ову шифру ваша URL адреса ће бити:

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

Можете да издате HTTP захтев користећи прегледач, Wget, curl или било који други механизам који изаберете. Успешан захтев ће вратити кôд одговора HTTP 200; ако добијете други одговор, проверите да нисте пречесто прослеђивали, да су шифра и URL адреса важеће и поново проследите захтев. Кôд одговора HTTP 200 означава само то да је претраживач примио вашу URL адресу.

Прослеђивање скупа URL адреса

Да бисте проследили скуп URL адреса преко HTTP захтева, издајте свој POST JSON захтев за URL адресу коју обезбеђују претраживачи. Замените именом хоста претраживача.

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

Можете да проследите до 10.000 URL адреса по објави, а по потреби можете и да комбинујете URL адресе које почињу са „http“ са оним које почињу са „https“.

Можете да издате HTTP захтев користећи Wget, curl или било који други механизам који изаберете. Успешан захтев ће вратити кôд одговора HTTP 200; ако добијете други одговор, проверите да је ваш захтев у реду и да све делује исправно и поново проследите захтев. Кôд одговора HTTP 200 означава само то да је претраживач примио скуп ваших URL адреса.

Препоручени начин је аутоматизација прослеђивања URL адреса чим се садржај дода, ажурира или избрише у одређеној мери; погледајте најбоље праксе за кориснички генерисан садржај у најчешћим питањима.

Верификовање власништва помоћу шифре

Да бисте проследили URL адресе, морате да „докажете“ власништво над хостом за који се прослеђују URL адресе и то хостовањем најмање једне текстуалне датотеке на хосту. Када проследите своје URL адресе претраживачима, претраживачи пописују датотеку шифре да би верификовали власништво и користе шифру док је не промените. Само ви и претраживачи смете да знате шифру и локацију датотеке шифре.

Ми нудимо два начина за верификовање власништва.

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