Όρια αιτημάτων

Κάθε λογαριασμός μπορεί να πραγματοποιεί 30 κλήσεις δημιουργίας συνδέσμων ανά παράθυρο 60 δευτερολέπτων, κοινές για τα REST POST /api/v1/links, POST /api/v1/uploads, POST /api/v1/sheets και το MCP create_links. Κάθε δέσμευση μεταφόρτωσης και υποβολή φύλλου καταναλώνει μία κλήση· οι επιμέρους μετατροπές συνδέσμων δεν καταναλώνουν καμία. Ένα άμεσο αίτημα και μια υποβολή παρτίδας καταναλώνουν από μία κλήση, ανεξάρτητα από τον αριθμό εισόδων.

Τα αιτήματα δημιουργίας που γίνονται δεκτά και οι απορρίψεις λόγω ορίου περιλαμβάνουν δομημένες κεφαλίδες:

RateLimit-Policy: "create-links";q=30;w=60
RateLimit: "create-links";r=29;t=60

Το q είναι η ποσόστωση και το w το παράθυρό της σε δευτερόλεπτα. Το r είναι οι κλήσεις που απομένουν· το t είναι τα δευτερόλεπτα μέχρι να ελευθερωθεί μια θέση. Πρόκειται για δομημένα πεδία, όχι σκέτους αριθμούς.

Η εξάντληση της ποσόστωσης επιστρέφει 429 με το πρόβλημα rate-limited και Retry-After σε δευτερόλεπτα. Περιμένετε πριν ξαναπροσπαθήσετε και συντονίστε τους πελάτες που χρησιμοποιούν τον ίδιο λογαριασμό. Η ανάγνωση εργασιών δεν καταναλώνει αυτή την ποσόστωση δημιουργίας· ακολουθήστε τις οδηγίες poll_after_seconds και Retry-After τους.

Παράθυρο αναζήτησηςΑντιγραφή συνδέσμου ενότητας

Οι αναζητήσεις λέξεων-κλειδιών έχουν ξεχωριστό παράθυρο 30 κλήσεων ανά λογαριασμό ανά 60 δευτερόλεπτα. Η αποδοχή αναζήτησης δεν καταναλώνει θέσεις δημιουργίας συνδέσμων. Οι επικολλήσεις που αναγνωρίζονται ως προϊόν, κατάστημα, φύλλο ή μη υποστηριζόμενος σύνδεσμος παρακάμπτουν την αναζήτηση λέξεων-κλειδιών και δεν καταναλώνουν κανένα παράθυρο· οι μη αναγνώσιμες επικολλήσεις ενδέχεται να φτάσουν στην αναζήτηση λέξεων-κλειδιών.

Οι επιτυχείς αποκρίσεις που φτάνουν στον έλεγχο αποδοχής αναζήτησης λέξεων-κλειδιών και οι απορρίψεις λόγω ορίου αναζήτησης περιλαμβάνουν:

RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60

Οι απορρίψεις αναζήτησης επιστρέφουν 429 με search-rate-limited και Retry-After. Τα πεδία κεφαλίδων έχουν την ίδια σημασία με παραπάνω. Η επανάληψη αιτήματος δημιουργίας με Idempotency-Key δεν καταναλώνει νέα θέση δημιουργίας συνδέσμων· το 429 δεν αποθηκεύεται για επανάληψη.