Rate Limits

De RealityConnect API past rate limiting toe op verzoeken per organisatie, met een token bucket per routefamilie. Deze pagina behandelt de buckets, de headers die elke rate-limited response bevat, en wat u moet doen bij 429 Too Many Requests.

---

Buckets

Elke bucket heeft een capaciteit (maximaal aantal tokens, d.w.z. burst-omvang) en een aanvulsnelheid (tokens toegevoegd per seconde, d.w.z. aanhoudende doorvoer). Een verzoek verbruikt één token; wanneer de bucket leeg is, wordt het verzoek geweigerd met 429.

Bucket	Capaciteit	Aanvulsnelheid	Omvat
assets	1000	10/s	RealityAssets, assettypen, assetcategorieën, aanmaken/lezen/weergeven/verwijderen van bedrijfsobjecten
twin	1000	10/s	Twin-ruimte, POI’s, zones, concepten
platform	1000	10/s	Site, datanode, data bundle, plug-ins
plan	1000	10/s	RealityPlan-ruimte, modelassets
library	1000	10/s	Asset Library-modellen en -tags
embed	100	2/s	Uitgifte van embed-sessies
users	1000	10/s	Gebruikers, groepen, rollen, uitnodigingen
sitefiles	1000	10/s	Sitebestanden

Rate limiting werkt per organisatie: alle OAuth-applicaties en gebruikers die namens dezelfde organisatie handelen, delen één bucket per familie.

Responseheaders

Elke rate-limited response, geslaagd of niet, bevat deze headers:

Header	Betekenis
X-RateLimit-Limit	De capaciteit van de bucket
X-RateLimit-Remaining	Resterende tokens in de bucket
X-RateLimit-Reset	Seconden tot de bucket weer vol is
X-RateLimit-Policy	{capacity};w={window}, waarbij window (seconden) gelijk is aan capacity / refillRate

Alleen bij 429 Too Many Requests bevat de response ook Retry-After (seconden tot ten minste één token beschikbaar is) en deze body:

{
  "statusCode": 429,
  "message": "Too Many Requests",
  "error": "rate_limited"
}

429 afhandelen

Vertraag op basis van Retry-After in plaats van een vaste wachttijd of een onmiddellijke nieuwe poging: een onmiddellijke nieuwe poging tegen een lege bucket levert alleen een nieuwe 429 op. Doseer bij aanhoudende workloads met een hoog volume uw verzoeken zodat u onder de aanvulsnelheid van de bucket blijft, in plaats van tot de capaciteit te bursten en de reset af te wachten.

Wat is de volgende stap?

• Zie de API-referentie voor de exacte bewerkingen onder elke bucket.