คู่มือ

การส่ง URL รายการเดียว

หากต้องการส่ง URL โดยใช้การร้องขอทาง HTTP (แทนที่ ด้วย URL ที่ได้รับจากโปรแกรมค้นหา) ให้ส่งคำขอไปที่ URL ต่อไปนี้:

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

• url-changed เป็น URL ของเว็บไซต์คุณซึ่งได้เพิ่ม อัปเดต หรือลบแล้ว URL ต้องเป็น URL-escaped และมีการเข้ารหัส โปรดตรวจดูให้แน่ใจว่า URL ของคุณสอดคล้องกับมาตรฐาน RFC-3986 สำหรับ URI
• Your-key ควรมีอักขระที่เป็นเลขฐานสิบหกไม่น้อยกว่า 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"
                      ]
                }
            

คุณสามารถส่ง URL ได้สูงสุดไม่เกิน 10,000 รายการต่อโพสต์ โดยรวมกันได้ทั้ง 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"
                          ]
                    }