procore-rate-limits
/procore-rate-limits
Wdraża adaptacyjne dławienie żądań Procore na podstawie nagłówków odpowiedzi w warunkach szczytu, godzinowych i dużego obciążenia, przy obsłudze 429 i 503 oraz ochronie zaległości webhooków.
- Autor
- jeremylongshore ↗
- Repozytorium
- tons-of-skills-marketplace ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 26.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 3
Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Wdraża adaptacyjne dławienie żądań Procore na podstawie nagłówków odpowiedzi w warunkach szczytu, godzinowych i dużego obciążenia, przy obsłudze 429 i 503 oraz ochronie zaległości webhooków.
Wyzwalacze z opisu
Argumenty
/procore-rate-limits [worker-and-request-class]
Oryginalny opis (EN)
Implement adaptive Procore throttling from response headers across spike, hourly, and heavy-load conditions. Use when handling 429 or 503 responses, sizing concurrency, or protecting webhook backlogs. Trigger with: "handle Procore rate limits", "fix Procore 429", "throttle Procore workers".
Jak działa
- Overview
- Prerequisites
- Instructions
- Authentication
- Tool Discipline
- Output
- Examples
- Error Handling
- Resources
Podgląd SKILL.md
--- name: procore-rate-limits description: >- Implement adaptive Procore throttling from response headers across spike, hourly, and heavy-load conditions. Use when handling 429 or 503 responses, sizing concurrency, or protecting webhook backlogs. Trigger with: "handle Procore rate limits", "fix Procore 429", "throttle Procore workers". allowed-tools: Read, Grep, Write, Edit version: 2.0.0 argument-hint: '[worker-and-request-class]' model: inherit effort: high license: MIT author: Jeremy Longshore <jeremy@intentsolutions.io> tags: - saas - procore - rate-limits - resilience compatibility: 'Requires access to Procore response headers and a queue or scheduler capable of pausing and bounding concurrency.' --- # Procore Header-Driven Rate Controller ## Overview Control throughput from the headers on each response instead of a hard-coded request count. Procore exposes whichever spike or hourly window is most likely to bind, and failed requests consume the same budget as successful calls. ## Prerequisites - Central request dispatcher with observable worker concurrency - Durable queue and a clock synchronized well enough to interpret reset timestamps - Metrics for status, route, remaining budget, reset time, retries, and backlog age ## Instructions ### Step 1: Capture every budget signal Record `X-Rate-Limit-Limit`, `X-Rate-Limit-Remaining`, and `X-Rate-Limit-Reset` from each response. Preserve `Retry-After` for heavy-load responses. ### Step 2: Pace before exhaustion Reduce dispatch concurrency as remaining budget falls and pause when it reaches zero. Treat the current headers as authoritative for either the spike or hourly window. ### Step 3: Handle throttling On 429, wait until after the reported reset and add jitter before resuming. On 503, obey `Retry-After`; never substitute an assumed delay. ### Step 4: Bound retries Retry safe reads within a capped policy. For writes, reconcile outcome or require an operation-specific idempotency design before another attempt. ### Step 5: Protect event backlogs Acknowledge webhook notifications quickly, enqueue downstream reads, and let the controller drain them. Monitor oldest-event age as well as queue depth. ### Step 6: Prove recovery Test low-budget, exhausted-budget, 429, and 503 fixtures. Verify one worker cannot bypass the shared controller and that recovery does not release a synchronized surge. ## Authentication Requests retain their existing OAuth 2.0 Bearer token and company routing. Throttling must not acquire alternate credentials to evade a rate boundary or log tokens alongside rate metadata. ## Tool Discipline Use Read and Grep to inspect dispatcher code, metrics, and provider headers. Use Write or Edit only for the approved limiter, queue policy, tests, or receipt; do not generate live load as a rate-limit test. ## Output - Header-driven pacing and retry policy - Deterministic limit and recovery tests - Route-level budget, backlog, and failure metrics Return the observed headers, controller decision, retry eligibility, next dispatch time, and verification outcome. ## Examples When remaining budget reaches zero, all workers stop until the reported reset plus jitter. A 503 follows its Retry-After value, while an ambiguous write is reconciled rather than replayed with the safe-read policy. ## Error Handling | Failure | Response | | --- | --- | | Rate headers missing | Reduce concurrency conservatively and surface telemetry loss; do not invent a limit. | | 429 repeats after reset | Increase jitter, lower concurrency, and inspect failed-call volume. | | Queue age breaches objective | Shed optional work and prioritize reconciliation without bypassing the limit. | | Write retry safety is unknown | Stop automatic retries and reconcile provider state. | ## Resources - [First-party source notes](references/official-docs.md) - [Rate limiting](https://developers.procore.com/documentation/rate-limiting) - [API Call Activity Report](https://developers.procore.com/documentation/api-activity-export) - [Error code reference](https://developers.procore.com/documentation/error-reference)
Pliki w paczce (2)
- SKILL.md 4 KB
- references/official-docs.md 1 KB
Wersje
W bazie nie ma innych skilli o nazwie procore-rate-limits.
Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.
Migawka bazy z 13.11.2026 · wersja paczki 05f04846d00b (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 1 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100procore-common-errors
Rozpoznaje awarie integracji Procore w OAuth, routingu, uprawnieniach, walidacji, paginacji, dławieniu i webhookach, bez poszerzania dostępu i ślepego ponawiania. - 100procore-sdk-patterns
Projektuje cienkiego klienta REST dla Procore, który zachowuje wersje endpointów, routing firmy, linki paginacji, błędy i nagłówki limitów, jako wspólny adapter HTTP zamiast kopiowanych żądań. - 100procore-webhooks
Odbiera i uwierzytelnia webhooki Procore dla firm budowlanych: sprawdza nagłówek Authorization, obsługuje zdarzenia RFI i dokumentów zgłoszeniowych. - 100deepgram-rate-limits
Wdraża limity zapytań i strategie backoff dla Deepgram: obsługa limitów API, dławienie żądań i błędy 429. - 100apollo-rate-limits
Wdraża limity zapytań i wycofywanie dla Apollo.io, w tym ponawianie i przepustowość żądań.