Error Handling

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "The 'claim' field is required and must be a non-empty string.",
    "docs": "https://signal-stack-ten.vercel.app/docs/api-reference/verify-claim",
    "request_id": "vrf_a1b2c3d4e5f6"
  }
}

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1700000000
Retry-After: 3600

# Python — exponential backoff with jitter
import time
import random

def verify_with_retry(client, max_retries=5):
    for attempt in range(max_retries):
        try:
            return client.verify.claim(claim="...")
        except signalstack.RateLimitError as e:
            wait = (2 ** attempt) + random.uniform(0, 1)
            time.sleep(min(wait, 60))
        except signalstack.ServerError as e:
            if attempt == max_retries - 1:
                raise
            wait = (2 ** attempt) + random.uniform(0, 1)
            time.sleep(min(wait, 120))
    raise signalstack.MaxRetriesExceeded()

// TypeScript — retry with backoff
async function verifyWithRetry(
  client: SignalStack,
  options: VerifyClaimOptions,
  maxRetries = 5,
) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      return await client.verify.claim(options)
    } catch (err) {
      if (err instanceof RateLimitError) {
        const wait = Math.min(2 ** attempt + Math.random(), 60)
        await sleep(wait * 1000)
      } else if (err instanceof ServerError) {
        if (attempt === maxRetries - 1) throw err
        const wait = Math.min(2 ** attempt + Math.random(), 120)
        await sleep(wait * 1000)
      } else {
        throw err
      }
    }
  }
  throw new MaxRetriesExceeded()
}