RemoteGymp · API v1

Limieten en fouten

Lees elke pagina, respecteer de snelheidslimieten en herstel veilig van fouten.

  1. Snelheidslimieten

    Limieten zijn configureerbaar. GET /v1/operations/capabilities rapporteert requestsPerMinute en authenticationRequestsPerMinutePerIp. Na een 429-fout, respecteer Retry-After en wacht langer als de beperking aanhoudt. Batchlezingen accepteren maximaal 100 ID's; individuele eindpunten kunnen kleinere pagina- of payloadlimieten hebben.

  2. Lees elke pagina

    Gebruik de vervolgregel voor het eindpunt dat u hebt aangeroepen, met behoud van dezelfde filters. Lijsten kunnen veranderen terwijl u ze leest; gebruik momentopnamen wanneer u een consistente kopie nodig hebt.

    PagineringDoorgaan metStoppen wanneer
    CursorGeef next door als after.Volgende is null.
    Verschuiven met nextOffsetGeef nextOffset door als offset.nextOffset is null.
    Offset met hasMoreVerhoog de offset met het aantal geretourneerde items.hasMore is onwaar.
    SoftwareGeef de numerieke waarde next door als after; herstart als updatedAtUtc verandert.Volgende is null.
    GebeurtenisfeedGeef next door als after.hasMore is onwaar.
  3. Foutafhandeling

    Lees de foutcode en de HTTP-status. Als het antwoord requestId bevat, vermeld dit dan bij contact met de supportafdeling.

    HTTP-statusWat te doen
    400Het verzoek corrigeren.
    401Controleer de inloggegevens of vraag een nieuw toegangstoken aan.
    403Controleer het bereik, de machtigingen en of de toegang is ingeschakeld.
    404De bron ontbreekt mogelijk of valt buiten uw bereik.
    409Lees de foutcode en de huidige status voordat u een beslissing neemt.
    410De momentopname of gebeurteniscursor is verlopen. Start een nieuwe basislijn.
  4. Als een schrijfbewerking een time-out bereikt

    Een time-out of 503 bewijst niet dat de actie is mislukt. Voor schrijfbewerkingen die bewerkingsbevestigingen retourneren, raadpleegt u GET /v1/operations/by-key?idempotencyKey={key} voordat u het opnieuw probeert. Voor het aanmaken van onderhoudsgegevens kunt u de originele Idempotency-Key en body hergebruiken.

API-referentie →

Inhoudsherziening 3f225a253 · OpenAPI SHA-256: b12c42306a89