Dokumentasi

Menghantar Satu URL


Untuk menghantar URL menggunakan permintaan HTTP (gantikan dengan URL yang disediakan oleh enjin gelintar), hantar permintaan anda ke URL berikut:

                https://<searchengine>/indexnow?url=url-changed&key=your-key
            
  • perubahan url adalah URL tapak web anda yang telah ditambah, dikemas kini atau dipadam. URL mestilah URL yang dikeluarkan dan terkod dan sila pastikan URL anda mematuhi standard RFC-3986 untuk URI.
  • Kekunci anda mesti mempunyai minimum 8 dan maksimum 128 aksara perenambelasan. Kekunci hanya boleh mengandungi aksara berikut: aksara huruf kecil (a-z), aksara huruf besar (A-Z), nombor (0-9) dan sengkang (-).

Contohnya, jika anda mahu memberitahu enjin gelintar yang https://www.example.com/product.html telah dikemas kini dan anda mahu menggunakan kekunci ini URL anda akan menjadi:

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

Anda boleh mengeluarkan permintaan HTTP menggunakan pelayar anda, wget, curl atau sebarang mekanisme pilihan anda. Permintaan berjaya akan mengembalikan kod respons HTTP 200; jika anda menerima respons berbeza, sahkan yang anda tidak menghantar dengan kerap, bahawa kekunci dan URL adalah sah dan menghantar semula permintaan. Kod respons HTTP 200 hanya menunjukkan yang enjin gelintar telah menerima URL anda.

Menghantar set URL


Untuk menghantar set URL menggunakan permintaan HTTP, keluarkan permintaan POST JSON anda ke URL yang disediakan olen Enjin Gelintar. Gantikan dengan nama hos enjin gelintar.

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

Anda boleh menghantar sehingga 10,000 URL setiap post, menggabungkan URLS http dan https jika perlu.

Anda boleh mengeluarkan permintaan HTTP menggunakan wget, curl atau mekanisme lain pilihan anda. Permintaan berjaya akan mengembalikan kod respons HTTP 200; jika anda menerima respons berbeza, anda perlu mengesahkan permintaan anda dan jika semuanya tiada masalah, hantar semula permintaan anda. Kod respons HTTP 200 hanya menunjukkan yang enjin gelintar telah menerima set URL anda.

Cara yang disyorkan adalah untuk mengautomatikkan penghantaran URL sejurus selepas kandungan ditambah, dikemas kini atau dipadam sehingga had tertentu; lihat amalan terbaik bagi pengguna menjana kandungan dalam Soalan Lazim.

Mengesahkan pemilikan melalui kekunci


Untuk menghantar URL, anda mesti “meluluskan” pemilikan hos yang URL sedang dihantar dengan pengehosan sekurang-kurangnya satu fail teks dalam hos. Setelah anda menghantar URL anda ke enjin gelintar, enjin gelintar akan mencari fail kekunci untuk mengesahkan pemilikan dan menggunakan kekunci sehingga anda menukar kekunci tersebut. Hanya anda dan enjin gelintar perlu tahu kekunci dan lokasi kekunci fail anda.

Kami menawarkan dua cara untuk mengesahkan pemilikan.

Pilihan 1
Pengehosan fail kekunci teks di direktori akar hos anda.

Anda mesti mengehoskan fail {kekunci-anda}.txt kekunci teks terkod UTF-8 di dalam fail di direktori akar tapak web anda.

Sebagai contoh untuk contoh sebelumnya, anda akan perlu mengehoskan fail kekunci UTF-8 anda di https://www.example.com/.txt dan fail ini mesti mengandungi kekunci

Pilihan 2
Mengehoskan fail kekunci teks dalam hos anda.

Anda juga boleh mengehoskan satu kepada banyak fail kekunci teks terkod UTF-8 di lokasi lain dalam hos yang sama dan anda mesti memberitahu enjin gelintar lokasi fail kekunci teks ini dalam setiap pemberitahuan IndexNow dengan menyatakan lokasi menggunakan pembolehubah keyLocation.

Jika anda menghantar URL, nyatakan lokasi fail kekunci sebagai nilai parameter URL keyLocation.

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

Jika anda menghantar set URLS, nyatakan lokasi fail kekunci sebagai pembolehubah keyLocation dalam kandungan JSON.

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

Dalam pilihan 2 ini, lokasi fail kekunci menentukan set URL yang boleh termasuk dengan kekunci ini. Fail kekunci berada di http://example.com/catalog/key12457EDd.txt boleh termasuk sebarang URL bermula dengan http://example.com/catalog/ tetapi tidak boleh termasuk URL bermula dengan http://example.com/help/.

URL tidak dikira sah dalam http://example.com/catalog/sitemap.xml termasuk:

URL yang tidak dikira sah dalam pilihan 2 mungkin tidak akan dikira untuk pengindeksan. Adalah sangat disyorkan yang anda menggunakan Pilihan 1 dan letakkan kekunci fail anda di direktori akar pelayan web anda.

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