Σφάλμα «μη έγκυρος σύνδεσμος» στο API: έλεγχος URL πριν από τη δημιουργία παραγγελίας

Τι σημαίνει το σφάλμα «μη έγκυρος σύνδεσμος» στο API

Το σφάλμα «μη έγκυρος σύνδεσμος» σημαίνει ότι το API δεν μπόρεσε να δεχτεί το URL στο πεδίο στόχου της παραγγελίας. Δεν πρόκειται πάντα για τυπογραφικό λάθος στη διεύθυνση. Η υπηρεσία μπορεί να απορρίψει τον σύνδεσμο λόγω ακατάλληλης μορφής, τύπου σελίδας, ανακατεύθυνσης, περιορισμών πρόσβασης, κωδικοποίησης ή αναντιστοιχίας πλατφόρμας με την υπηρεσία.

Ο έλεγχος συνήθως πραγματοποιείται πριν από τη δημιουργία της παραγγελίας. Το API λαμβάνει το URL, προσδιορίζει τον τομέα και τη διαδρομή, προσπαθεί να αναγνωρίσει το αντικείμενο: κανάλι, βίντεο, μετάδοση, δημοσίευση ή προφίλ. Αν ένα από τα στάδια αποτύχει, η παραγγελία δεν θα δημιουργηθεί. Το γενικό κείμενο του σφάλματος από μόνο του δεν δείχνει την αιτία — πρέπει να εξετάσετε το URL, τις παραμέτρους της υπηρεσίας και την πλήρη απάντηση του API.

Αντιστοιχίστε το κείμενο του σφάλματος με την απάντηση του API

Διαφορετικά API έχουν διαφορετική διατύπωση και δομή απάντησης. Μερικές φορές η υπηρεσία επιστρέφει μόνο ένα μήνυμα, άλλες φορές προσθέτει κωδικό, όνομα πεδίου ή αναγνωριστικό αιτήματος. Η πλήρης απάντηση είναι πιο χρήσιμη από την κατάσταση HTTP: ακόμη και με επιτυχή παράδοση του αιτήματος, το API μπορεί να απορρίψει την ίδια την παραγγελία σε επίπεδο επιχειρηματικού ελέγχου.

Για παράδειγμα, μια τυπική απάντηση μπορεί να μοιάζει έτσι: {"error":"invalid_link","message":"Invalid target URL","field":"link"}. Εδώ αξίζει να ελέγξετε συγκεκριμένα την τιμή του πεδίου link. Η παραλλαγή {"error":"target_not_supported"} υποδεικνύει συχνότερα όχι μια χαλασμένη διεύθυνση, αλλά έναν μη υποστηριζόμενο τύπο αντικειμένου. Τα ονόματα των πεδίων και οι κωδικοί εξαρτώνται από τη συγκεκριμένη τεκμηρίωση.

Διατηρήστε την κατάσταση της απάντησης, το σώμα της απάντησης, το αναγνωριστικό της υπηρεσίας και το request_id, αν το API το επιστρέφει. Μην προσθέτετε στο ticket το token πρόσβασης, τα cookies, τις υπογραφές του αιτήματος και τις ιδιωτικές παραμέτρους του συνδέσμου.

Ελέγξτε τη μορφή του URL και την τιμή του πεδίου του αιτήματος

Ένας σύνδεσμος που λειτουργεί στο πρόγραμμα περιήγησης μπορεί να μην περάσει τον μηχανικό έλεγχο. Στο πεδίο μερικές φορές καταλήγει μόνο το αναγνωριστικό του βίντεο, ένα ψευδώνυμο χωρίς τομέα, κείμενο από ένα μήνυμα ή μια συντομευμένη διεύθυνση. Το σφάλμα προκύπτει επίσης όταν το URL δεν μεταδίδεται ως συμβολοσειρά, αλλά ως ένθετο αντικείμενο ή πίνακας.

• Μεταδίδετε το πλήρες δημόσιο URL μαζί με το πρωτόκολλο https://.
• Ελέγξτε τον τομέα: πρέπει να ανήκει στην πλατφόρμα της επιλεγμένης υπηρεσίας.
• Αφαιρέστε τα κενά στα άκρα, τις αλλαγές γραμμής, τα emoji και το κείμενο μετά τον σύνδεσμο.
• Επαληθεύστε το όνομα του πεδίου με την τεκμηρίωση του API: link, url, target ή άλλο.
• Βεβαιωθείτε ότι στο αίτημα μεταδίδεται μια τιμή συμβολοσειράς και όχι ένα αντικείμενο με URL μέσα.

Η χειροκίνητη επικόλληση της διεύθυνσης είναι βολική, αλλά έχει ένα μειονέκτημα: στη συμβολοσειρά εύκολα εισχωρεί ένας αόρατος χαρακτήρας ή ένα απόσπασμα της λεζάντας της δημοσίευσης. Πριν από την αποστολή, καθαρίστε την τιμή, αλλά μην αλλάζετε την ίδια τη διαδρομή και τις παραμέτρους χωρίς λόγο.

Αναπτύξτε τους σύντομους συνδέσμους και αφαιρέστε τις περιττές ανακατευθύνσεις

Οι συντομευμένες διευθύνσεις και οι σύνδεσμοι από το κουμπί «Κοινοποίηση» περνούν συχνά από μία ή περισσότερες ανακατευθύνσεις. Το πρόγραμμα περιήγησης τις ανοίγει αυτόματα, αλλά το API της υπηρεσίας προώθησης μπορεί να μην ακολουθεί τις ανακατευθύνσεις, να τις μπλοκάρει ή να λαμβάνει μια ενδιάμεση σελίδα εξουσιοδότησης.

Για την παραγγελία είναι προτιμότερο να χρησιμοποιείτε την κανονική διεύθυνση: αυτή που φαίνεται στη γραμμή διευθύνσεων μετά την πλήρη φόρτωση της επιθυμητής σελίδας. Οι ετικέτες καμπανιών και οι παράμετροι χρόνου προβολής δεν εμποδίζουν πάντα, αλλά οι παράμετροι μπορεί να οδηγήσουν σε διαφορετική αναπαράσταση της σελίδας ή να επηρεάσουν την αναγνώριση του αντικειμένου.

Το κανονικό URL έχει ένα μειονέκτημα: μερικές φορές πρέπει να το αποκτήσετε ξεχωριστά, ειδικά μετά την αντιγραφή του συνδέσμου από μια εφαρμογή για κινητά. Ωστόσο, μια τέτοια διεύθυνση είναι ευκολότερο να ελεγχθεί χειροκίνητα και να αντιστοιχιστεί με τους κανόνες της υπηρεσίας.

Επιλέξτε σύνδεσμο προς αντικείμενο που δέχεται η υπηρεσία

Η υπηρεσία μπορεί να δέχεται μόνο έναν τύπο στόχου. Η παραγγελία για κανάλι δεν θα δεχτεί σύνδεσμο προς εγγραφή μετάδοσης, και η υπηρεσία για προβολές βίντεο δεν θα δεχτεί το προφίλ του δημιουργού. Εξωτερικά και τα δύο URL είναι σωστά, αλλά το API αντιστοιχίζει τη δομή της διεύθυνσης με τον σκοπό της υπηρεσίας και απορρίπτει το ακατάλληλο αντικείμενο.

Ελέγξτε τον κατάλογο υπηρεσιών: την πλατφόρμα, την κατηγορία, το επιτρεπόμενο target_type και τους περιορισμούς. Αν το API απαιτεί ξεχωριστή παράμετρο τύπου στόχου, αυτή πρέπει να συμφωνεί με το URL. Μην αντικαθιστάτε τη διεύθυνση του περιεχομένου με σύνδεσμο προς αναζήτηση, hashtag, συλλογή, αρχική σελίδα ή λογαριασμό του δημιουργού.

• Για την προώθηση καναλιού μεταδίδετε τη σελίδα του καναλιού.
• Για προβολές χρησιμοποιείτε τον σύνδεσμο προς συγκεκριμένο βίντεο ή εγγραφή.
• Για ενεργή μετάδοση μεταδίδετε το URL της μετάδοσης, αν η υπηρεσία υποστηρίζει μορφή live.
• Για αντιδράσεις και άλλες ενέργειες με δημοσίευση χρησιμοποιείτε απευθείας σύνδεσμο προς τη δημοσίευση.

Ελέγξτε την ιδιωτικότητα, τα φίλτρα ηλικίας και την απαίτηση σύνδεσης

Το API ελέγχει όχι μόνο τη μορφή του URL, αλλά και τη διαθεσιμότητα του στόχου. Το περιεχόμενο μπορεί να ανοίγει στον κάτοχο του καναλιού, επειδή το πρόγραμμα περιήγησής του είναι εξουσιοδοτημένο, αλλά να μην είναι προσβάσιμο σε έναν εξωτερικό διακομιστή ελέγχου. Σε αυτή την περίπτωση, η υπηρεσία συχνά επιστρέφει ένα γενικό σφάλμα για μη έγκυρο σύνδεσμο.

• Ελέγξτε αν το προφίλ, το κανάλι, η δημοσίευση ή η ίδια η μετάδοση είναι κλειστά.
• Βεβαιωθείτε ότι το βίντεο δεν έχει διαγραφεί, δεν έχει μετακινηθεί σε πρόχειρα και δεν έχει αντικατασταθεί από άλλη δημοσίευση.
• Ελέγξτε τον ηλικιακό περιορισμό: μπορεί να απαιτεί επιβεβαίωση ηλικίας ή σύνδεση σε λογαριασμό.
• Απενεργοποιήστε τη λειτουργία πρόσβασης μόνο για συνδρομητές, μέλη ή εγκεκριμένους θεατές, αν είναι ενεργοποιημένη.
• Βεβαιωθείτε ότι η σελίδα δεν εμφανίζει φόρμα σύνδεσης, προειδοποίηση περιεχομένου ή τεχνικό placeholder.

Ανοίξτε τον σύνδεσμο σε ιδιωτικό παράθυρο χωρίς εξουσιοδότηση. Αν αντί για τη σελίδα προορισμού εμφανίζεται αίτημα σύνδεσης, αλλάξτε τις ρυθμίσεις πρόσβασης ή επιλέξτε μια υπηρεσία που επιτρέπει αυτόν τον τύπο στόχου, αν προβλέπεται. Το μειονέκτημα του ελέγχου σε ιδιωτικό παράθυρο είναι ότι δεν εντοπίζει πάντα περιφερειακούς και δικτυακούς περιορισμούς.

Λάβετε υπόψη τις περιφερειακές, κινητές και ενσωματωμένες διευθύνσεις

Ένα αντικείμενο μπορεί να έχει URL για υπολογιστή, για κινητό, τοπικοποιημένο και ενσωματωμένο. Η διεύθυνση από μια εφαρμογή ή webview περιέχει μερικές φορές τεχνικά τμήματα που το API δεν αναγνωρίζει. Η τοπικοποιημένη σελίδα μπορεί επίσης να ανοίγει διαφορετικά για τον διακομιστή ελέγχου.

Ανοίξτε τον αντιγραμμένο σύνδεσμο σε ένα συνηθισμένο πρόγραμμα περιήγησης και περιμένετε την πλήρη φόρτωση. Για το αίτημα χρησιμοποιήστε τη δημόσια διαδικτυακή διεύθυνση από τη γραμμή διευθύνσεων. Αν το περιεχόμενο είναι περιορισμένο ανά περιοχή, αφαιρέστε τον περιορισμό, αν το επιτρέπουν οι ρυθμίσεις της πλατφόρμας, ή μην στέλνετε έναν τέτοιο στόχο σε υπηρεσία που απαιτεί δημόσια πρόσβαση.

Ένας δημόσιος διαδικτυακός σύνδεσμος χωρίς εξουσιοδότηση και ενδιάμεσες οθόνες είναι η πιο αξιόπιστη επιλογή για τον έλεγχο του API.

Αποκλείστε την αλλοίωση του URL κατά την αποστολή του αιτήματος

Ο σύνδεσμος μπορεί να είναι σωστός πριν από την αποστολή, αλλά να αλλάξει κατά τη σειριοποίηση JSON, τη σύνθεση query-παραμέτρων, την αποστολή form-data ή την εκ νέου κωδικοποίηση. Ιδιαίτερα ευαίσθητοι είναι οι χαρακτήρες &, ?, # και %. Για παράδειγμα, το ampersand σε ένα URL μπορεί να γίνει διαχωριστικό παραμέτρων του ίδιου του αιτήματος, αν η διεύθυνση μεταδίδεται χωρίς την απαραίτητη κωδικοποίηση.

• Συγκρίνετε το αρχικό URL με την τιμή στο πραγματικό αίτημα HTTP.
• Ελέγξτε το σώμα του αιτήματος στα αρχεία καταγραφής του πελάτη, του proxy ή στα εργαλεία προγραμματιστή.
• Για JSON χρησιμοποιείτε την τυπική σειριοποίηση, όχι χειροκίνητη σύνθεση συμβολοσειράς.
• Μην κωδικοποιείτε το URL δύο φορές, αν η βιβλιοθήκη το κάνει αυτόματα.
• Ελέγξτε τον χειρισμό των κυριλλικών στη διαδρομή και στις παραμέτρους της διεύθυνσης.

Τα αρχεία καταγραφής βοηθούν να εντοπίσετε γρήγορα την απόκλιση, αλλά έχουν ένα μειονέκτημα: μπορεί να περιέχουν κλειδιά API, tokens και προσωπικά δεδομένα. Αποκρύψτε τις ευαίσθητες τιμές πριν από την εγγραφή και τη μεταβίβαση των αρχείων καταγραφής.

Επαληθεύστε την πλατφόρμα, το αναγνωριστικό υπηρεσίας και τις παραμέτρους της παραγγελίας

Ορισμένα API ελέγχουν πρώτα την υπηρεσία και μετά τον τομέα και τον τύπο του συνδέσμου. Ένα URL άλλης πλατφόρμας, ένα παρωχημένο service_id ή ένα λανθασμένο target_type μπορεί να οδηγήσουν στο ίδιο σφάλμα «μη έγκυρος σύνδεσμος». Σε αυτή την περίπτωση, η αλλαγή της ίδιας της διεύθυνσης είναι άχρηστη μέχρι να διορθωθούν οι παράμετροι της παραγγελίας.

Ενημερώνετε τον κατάλογο υπηρεσιών μέσω της μεθόδου API, αν προβλέπεται. Η προσωρινή μνήμη με μια παλιά λίστα μπορεί να διατηρεί μια απενεργοποιημένη υπηρεσία ή τις προηγούμενες απαιτήσεις της. Η συχνή ενημέρωση του καταλόγου έχει ένα μειονέκτημα: αυξάνει τον αριθμό των αιτημάτων και μπορεί να συναντήσει το όριο συχνότητας. Χρησιμοποιήστε προσωρινή μνήμη με περιορισμένο χρόνο αποθήκευσης και ενημερώστε την μετά από σφάλματα επικύρωσης.

Ελέγξτε τον σύνδεσμο με τη σειρά πριν από την εκ νέου αποστολή

1. Αντιγράψτε το πλήρες URL χωρίς κείμενο, κενά και κρυφούς χαρακτήρες.
2. Ανοίξτε το σε ιδιωτικό παράθυρο χωρίς σύνδεση σε λογαριασμό.
3. Ελέγξτε ότι η σελίδα δεν είναι κλειστή, δεν έχει διαγραφεί και δεν απαιτεί σύνδεση.
4. Βεβαιωθείτε ότι δεν υπάρχει ηλικιακός, συνδρομητικός ή περιφερειακός περιορισμός.
5. Αναπτύξτε τον σύντομο σύνδεσμο μέχρι την τελική δημόσια διεύθυνση.
6. Αντιστοιχίστε το αντικείμενο στο URL με την υπηρεσία: κανάλι, βίντεο, μετάδοση ή δημοσίευση.
7. Επαληθεύστε την πλατφόρμα, το service_id και το target_type με τον τρέχοντα κατάλογο υπηρεσιών.
8. Ελέγξτε το πραγματικό σώμα του αιτήματος HTTP και την κωδικοποίηση του URL.
9. Διατηρήστε την πλήρη απάντηση του API και το αναγνωριστικό αιτήματος χωρίς tokens και ιδιωτικά δεδομένα.

Αν μετά από αυτούς τους ελέγχους το σφάλμα παραμένει, στείλτε στην υποστήριξη τον σύνδεσμο σε καθαρή μορφή, το αναγνωριστικό υπηρεσίας, την ώρα του αιτήματος, την κατάσταση HTTP και το πλήρες κείμενο της απάντησης του API. Αυτό θα επιτρέψει να διακρίνετε το πρόβλημα του URL από τον περιορισμό μιας συγκεκριμένης υπηρεσίας ή μια βλάβη του ελέγχου στην πλευρά της υπηρεσίας.