文档

提交一个 URL

要使用 HTTP 请求提交一个URL（用搜索引擎提供的 URL 替换 ），请向以下 URL 发出请求：

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

• 已更改 URL 是你已被添加、更新或删除网站的一个 URL。URL 必须经过 URL 转义和编码，请确保你的 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=
            

你可以使用浏览器、wget、curl 或你选择的任何其他机制发出 HTTP 请求。请求成功将返回一个 HTTP 200 响应代码；如果你收到不同的响应，请验证提交的次数是否过多，密钥和 URL 是否有效，并重新提交请求。HTTP 200 响应代码只表明搜索引擎已收到你的 URL。

提交一组 URL

要使用 HTTP 请求提交一组 URL，请向搜索引擎提供的 URL 发出 POST JSON 请求。用搜索引擎的主机名称替换

                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，如果需要，可以混合 http 和 https URL。

你可以使用 wget、curl 或你选择的任何其他机制发出 HTTP 请求。请求成功将返回一个 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"
                          ]
                    }