Aanroeplimieten

Elk account kan 30 aanroepen voor linkaanmaak doen per venster van 60 seconden, gedeeld door REST POST /api/v1/links, POST /api/v1/uploads, POST /api/v1/sheets en MCP create_links. Een directe aanvraag en een batchaanvraag gebruiken elk één aanroep, ongeacht het aantal invoerwaarden. Elke uploadreservering en spreadsheetindiening gebruikt één oproep; onderliggende linkconversies gebruiken er geen.

Toegelaten aanmaakaanvragen en weigeringen wegens de aanroeplimiet bevatten gestructureerde headers:

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

q is het quotum en w het venster in seconden. r is het aantal resterende aanroepen; t is het aantal seconden tot er een plek vrijkomt. Dit zijn gestructureerde velden, geen losse getallen.

Bij een opgebruikt quotum krijg je 429 met het probleem rate-limited en Retry-After in seconden. Wacht voordat je opnieuw probeert en stem aanroepers van hetzelfde account op elkaar af. Taakaanvragen verbruiken dit quotum niet; volg hun aanwijzingen voor poll_after_seconds en Retry-After.

ZoekvensterSectielink kopiëren

Zoekopdrachten op zoekwoorden hebben een eigen venster van 30 aanroepen per account per 60 seconden. Zoektoelating verbruikt geen linkaanroepen. Herkende product-, verkoper-, spreadsheet- en niet ondersteunde links slaan zoekwoorden over en verbruiken geen van beide quota; onleesbare links kunnen tot een zoekopdracht leiden.

Geslaagde antwoorden na de toelatingscontrole voor zoekwoorden en weigeringen wegens de zoeklimiet bevatten:

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

Geweigerde zoekopdrachten geven 429 met search-rate-limited en Retry-After. De headervelden betekenen hetzelfde als hierboven. Opnieuw afspelen met Idempotency-Key verbruikt geen extra linkaanroep; een 429 wordt niet opgeslagen voor herhaling.