Limity wywołań

Każde konto może wykonać 30 wywołań tworzenia linków w oknie 60 sekund, wspólnie dla REST POST /api/v1/links, POST /api/v1/uploads, POST /api/v1/sheets i MCP create_links. Żądanie bezpośrednie i przesłanie partii zużywają po jednym wywołaniu, niezależnie od liczby danych wejściowych. Każda rezerwacja przesyłania i zgłoszenie arkusza zużywa jedno wywołanie; podrzędne konwersje linków nie zużywają żadnego.

Przyjęte żądania tworzenia i odmowy z powodu limitu zawierają ustrukturyzowane nagłówki:

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

q to limit, a w to okno w sekundach. r to liczba pozostałych wywołań; t to sekundy do zwolnienia miejsca. Są to pola ustrukturyzowane, a nie same liczby.

Wyczerpanie limitu zwraca 429 z problemem rate-limited i Retry-After w sekundach. Poczekaj przed ponowieniem i skoordynuj klientów używających tego samego konta. Odczyty zadań nie zużywają tego limitu; stosuj ich wskazówki poll_after_seconds i Retry-After.

Okno wyszukiwaniaKopiuj link do sekcji

Wyszukiwanie słów kluczowych ma osobne okno 30 wywołań na konto w ciągu 60 sekund. Dopuszczenie wyszukiwania nie zużywa wywołań tworzenia linków. Rozpoznane linki do produktów, sprzedawców, arkuszy i linki nieobsługiwane pomijają wyszukiwanie słów kluczowych i nie zużywają żadnego z obu limitów; nieodczytane linki mogą do niego trafić.

Poprawne odpowiedzi po kontroli dopuszczenia do wyszukiwania słów kluczowych oraz odmowy z powodu limitu zawierają:

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

Odrzucone wyszukiwania zwracają 429 z search-rate-limited i Retry-After. Pola nagłówków mają znaczenie takie jak wyżej. Odtworzenie z Idempotency-Key nie zużywa kolejnego wywołania tworzenia linków; 429 nie jest zapisywane do odtworzenia.