shopify-rate-limits

# Shopify Rate Limits ## Overview Shopify uses two distinct rate limiting systems: leaky bucket for REST and calculated query cost for GraphQL. This skill covers both with real header values and response shapes. ## Prerequisites - Understanding of Shopify's REST and GraphQL Admin APIs - Familiarity with the `@shopify/shopify-api` library ## Instructions ### Step 1: Understand the Two Rate Limit Systems **REST Admin API** — Leaky Bucket: | Plan | Bucket Size | Leak Rate | |------|------------|-----------| | Standard | 40 requests | 2/second | | Shopify Plus | 80 requests | 4/second | The `X-Shopify-Shop-Api-Call-Limit` header shows your bucket state: ``` X-Shopify-Shop-Api-Call-Limit: 32/40 ``` Means: 32 of 40 slots used. When full, you get HTTP 429 with `Retry-After` header. **GraphQL Admin API** — Calculated Query Cost: | Plan | Max Available | Restore Rate | |------|--------------|-------------| | Standard | 1,000 points | 50 points/second | | Shopify Plus | 2,000 points | 100 points/second | Every GraphQL response includes cost info in `extensions`: ```json { "extensions": { "cost": { "requestedQueryCost": 252, "actualQueryCost": 12, "throttleStatus": { "maximumAvailable": 1000.0, "currentlyAvailable": 988.0, "restoreRate": 50.0 } } } } ``` Key insight: `requestedQueryCost` is the *worst case* estimate. `actualQueryCost` is the real cost (often much lower). When `currentlyAvailable` drops to 0, you...