Error codes · Limits

Rate limited

What it means

Too many requests in the current window. The limit is either one Anis staff set on your application or wallet — counting all requests, orders only, or reveals only — or Anis’s own protection. Nothing was recorded against the request. During enrolment it also means the proof has failed five times.

What to do

• Wait for the time in Retry-After when it is present; otherwise back off exponentially.
• Then send again. An order may keep its operation id: a refusal at the door records nothing against it.
• During enrolment, after five failed proofs: ask Anis staff to restart the enrolment.

Where you can meet it

• GETRead your profile/v1/profile
• GETList wallets/v1/wallets
• GETRead a wallet/v1/wallets/{walletId}
• GETList catalogue categories/v1/wallets/{walletId}/catalog/categories
• GETList subcategories of a category/v1/wallets/{walletId}/catalog/categories/{categoryId}/subcategories
• GETRead a subcategory/v1/wallets/{walletId}/catalog/subcategories/{subcategoryId}
• GETList cards for sale/v1/wallets/{walletId}/catalog/subcategories/{subcategoryId}/cards
• POSTPlace an order/v1/wallets/{walletId}/orders
• GETRead an order/v1/orders/{operationId}
• GETList owned cards/v1/wallets/{walletId}/cards
• GETRead an owned card/v1/wallets/{walletId}/cards/{soldCardId}
• POSTReveal a card/v1/wallets/{walletId}/cards/{soldCardId}/reveal
• POSTReveal an invoice/v1/wallets/{walletId}/invoices/{invoiceId}/cards/reveal
• POSTCheck your signature/v1/diagnostics/signature
• GETRead an invitation/v1/enrollments/{invitationId}
• POSTSubmit a public key/v1/enrollments/{invitationId}/keys
• POSTProve you hold the key/v1/enrollments/{invitationId}/proof
• GETRead enrolment status/v1/enrollments/{invitationId}/status

Example

The body of the refusal. Its type is the address of this page.

{
  "type": "https://developers.anis.ly/errors/rate-limited",
  "title": "Rate limited",
  "status": 429,
  "code": "rate_limited",
  "requestId": "01J9R2K8T4V6XQ0M3B7C5D9E1F"
}