Τεκμηρίωση

Υποβολή μίας διεύθυνσης URL

Για να υποβάλετε μια διεύθυνση URL με αίτηση HTTP (αντικαταστήστε το στοιχείο με τη διεύθυνση URL που παρέχεται από τον μηχανισμό αναζήτησης), υποβάλετε την αίτησή σας στην ακόλουθη διεύθυνση URL:

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

• Το url-changed είναι μια διεύθυνση URL της τοποθεσίας web που προστέθηκε, ενημερώθηκε ή διαγράφηκε. Η διεύθυνση URL πρέπει να είναι URL-escaped και encoded και πρέπει να βεβαιωθείτε ότι οι διευθύνσεις URL σας ακολουθούν το πρότυπο RFC-3986 για URI.
• Η τιμή your-key πρέπει να έχει το ελάχιστο 8 και το μέγιστο 128 δεκαεξαδικούς χαρακτήρες. Το κλειδί μπορεί να περιλαμβάνει τους εξής χαρακτήρες: πεζούς χαρακτήρες (a-z), κεφαλαίους χαρακτήρες (A-Z), αριθμούς (0-9) και παύλες (-).

Για παράδειγμα, αν θέλετε να ειδοποιήσετε τους μηχανισμούς αναζήτησης ότι η διεύθυνση https://www.example.org/product.html ενημερώθηκε και θέλετε να χρησιμοποιήσετε αυτό το κλειδί η διεύθυνση URL σας θα είναι:

                https://<searchengine>/indexnow?url=https://www.example.org/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.org",
                  "key": "",
                  "urlList": [
                      "https://www.example.org/url1",
                      "https://www.example.org/folder/url2",
                      "https://www.example.org/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.org/product.html&key=&keyLocation=http://www.example.org/myIndexNowKey63638.txt
                

                    POST /indexnow HTTP/1.1
                    Content-Type: application/json; charset=utf-8
                    Host: <searchengine>
                    {
                      "host": "www.example.org",
                      "key": "",
                      "keyLocation": "https://www.example.org/myIndexNowKey63638.txt",
                      "urlList": [
                          "https://www.example.org/url1",
                          "https://www.example.org/folder/url2",
                          "https://www.example.org/url3"
                          ]
                    }