Tài liệu

Gửi một URL

Để gửi URL bằng yêu cầu HTTP (sử dụng URL mà công cụ tìm kiếm cung cấp thay cho ), hãy đưa ra yêu cầu cho URL sau:

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

• url-changed là URL trang web đã được thêm, cập nhật hay xóa của bạn. URL phải được thoát và mã hóa URL; vui lòng đảm bảo các URL của bạn tuân thủ chuẩn RFC-3986 cho các URI.
• Khóa cần có số ký tự thập lục phân tối thiểu và tối đa lần lượt là 8 và 128 ký tự. Khóa chỉ được chứa các ký tự sau: ký tự chữ thường (a-z), ký tự chữ hoa (A-Z), số (0-9) và dấu gạch nối (-).

Ví dụ: nếu muốn thông báo cho công cụ tìm kiếm rằng https://www.example.com/product.html đã được cập nhật và bạn muốn dùng khóa này thì URL của bạn sẽ là:

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

Bạn có thể sử dụng trình duyệt, lệnh wget, lệnh curl hay bất cứ cách thức nào khác tùy chọn để đưa ra yêu cầu HTTP. Một yêu cầu thành công sẽ trả về mã phản hồi HTTP 200; nếu nhận được phản hồi khác, hãy đảm bảo rằng bạn không gửi yêu cầu quá thường xuyên và cả khóa và URL đều hợp lệ, sau đó gửi lại yêu cầu. Mã phản hồi HTTP 200 chỉ cho biết rằng công cụ tìm kiếm đã nhận được URL của bạn.

Gửi tập hợp nhiều URL

Để gửi tập hợp nhiều URL bằng yêu cầu HTTP, hãy đưa ra yêu cầu POST JSON cho URL mà Công cụ tìm kiếm cung cấp. Thay bằng tên máy chủ của công cụ tìm kiếm.

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

Với mỗi lần đăng, bạn có thể gửi tối đa 10.000 URL, kết hợp cả URL http và https nếu cần.

Bạn có thể sử dụng lệnh wget, lệnh curl hay bất cứ cách thức nào khác tùy chọn để đưa ra yêu cầu HTTP. Một yêu cầu thành công sẽ trả về mã phản hồi HTTP 200; nếu nhận được phản hồi khác, bạn nên xác minh lại yêu cầu và đảm bảo mọi thứ chính xác, sau đó gửi lại yêu cầu. Mã phản hồi HTTP 200 chỉ cho biết rằng công cụ tìm kiếm đã nhận được tập hợp các URL của bạn.

Chúng tôi khuyên bạn nên thực hiện việc gửi tự động các URL ngay khi thêm, cập nhật hoặc xóa nội dung trong phạm vi giới hạn nào đó; xem các thực hành tốt nhất cho nội dung do người dùng tạo trong phần Câu hỏi thường gặp.

Xác minh quyền sở hữu bằng cách sử dụng khóa

Để gửi các URL, bạn phải "chứng minh" quyền sở hữu máy chủ mà URL đang được gửi bằng cách lưu trữ ít nhất một tệp văn bản trong máy chủ đó. Sau khi gửi các URL đến công cụ tìm kiếm, công cụ tìm kiếm sẽ cào dữ liệu (crawl) tệp khóa để xác minh quyền sở hữu và sử dụng khóa này cho đến khi bạn thay đổi khóa. Sẽ chỉ có bạn và công cụ tìm kiếm biết khóa này, cũng như vị trí khóa tệp.

Chúng tôi giới thiệu đến bạn hai cách để xác minh quyền sở hữu.

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