La Paz Supermercado External player market
Supermercado

Policy

API Use

Cartel Empire API Rules

La Paz Supermercado uses Cartel Empire API data after a player connects their own API key for seller tools, or through a dedicated site-owned service key for public item catalog refreshes.

Request Scope

  • We request `/user`, `/inventory`, and `/items` because those are required for shop ownership, sell eligibility, item descriptions, prices, and circulation.
  • We do not request `/chat` for marketplace browsing, selling, or shop management.
  • We do not pool API keys to increase limits.
  • Connected seller keys are encrypted server-side and used hourly only to refresh that seller's own inventory-backed tienda data.
  • A dedicated service key can refresh public item catalog data such as item value and circulation.
  • Gear stats and listing quantities come from the normal `/inventory` and `/items` sync data; there is no separate stat-only API call.
  • Requests include a descriptive `desc` value for Cartel Empire API logging.

Rate Limits

Cartel Empire currently documents most endpoints at 200 requests per player per 60-second window, with limits subject to change. The Chat endpoint is limited to 3 requests per 60 seconds, but this marketplace does not use Chat. API responses are cached for a short period per key so repeated user actions do not hammer Cartel Empire servers.

Backoff Behavior

When Cartel Empire returns HTTP 429, the app reads `Retry-After` when present and tells the player to wait instead of retry-spamming. RateLimit headers are treated as the source of truth because Cartel Empire may change limits with little or no notice.

Player Revocation

Players can revoke marketplace API authorization at any time. The app then removes the stored key hash, encrypted key material, and key-tied API cache, clears the seller cookie, pauses active listings, disables public buy prices, and hides the tienda.

Conditional Requests

Cartel Empire supports ETag-based conditional requests for some single-type list selections. Those list selections are not required for V1 item marketplace functions, and 304 responses still count against the API limit.