FightCase storefront API

Read-only catalogue of FightCase phone cases with fight-sport designs: products, prices in EUR/CZK/USD, phone models, fighters, organizations and shop policies.

Public JSON endpoints used by the FightCase storefront. They are read-only and need no authentication. Use them to find a case, its exact price and the phone models it is made for, then send the person to the product page (https://fightcase.adscaled.media/case/<slug>) to choose the model and pay. Payment happens only on Stripe Checkout, entered by the buyer; there is no API to place or pay an order. GET /api/v1/shop reports checkoutAvailable: when it is false, orders are not open yet. Versioning: the major version is in the path (/api/v1/); the unversioned /api/… paths are aliases of v1 used by the storefront. Deprecation policy: v1 only gets backward-compatible additions; a breaking change ships as /api/v2/. A deprecated operation is marked deprecated: true here and answers with Deprecation (RFC 9745) and Sunset (RFC 8594) headers; it stays available for at least 90 days after the deprecation is announced. Nothing is deprecated today.

Endpoints

GET /api/v1/health

Operation getHealth. Health check. Returns { "ok": true } while the shop server is running.

curl 'https://fightcase.adscaled.media/api/v1/health'

Responses:

GET /api/v1/shop

Operation getShop. Shop status. Whether checkout is open, seller details from the shop settings, categories, phone models, shipping countries, delivery estimate and active deals.

ParameterInRequiredValuesDescription
langquerynoen, cs, ru, de, frLanguage of the texts. Missing translations fall back to English.
curl 'https://fightcase.adscaled.media/api/v1/shop?lang=en'

Responses:

GET /api/v1/products

Operation listProducts. List products. Active products, optionally filtered. Every search word must match (title, tags, category, fighter, organization; diacritics ignored).

ParameterInRequiredValuesDescription
langquerynoen, cs, ru, de, frLanguage of the texts. Missing translations fall back to English.
qquerynostring, max 80Search text.
categoryquerynostring, max 80Category slug (see GET /api/v1/shop categories).
fighterquerynostring, max 80Fighter slug (see GET /api/v1/filters).
organizationquerynostring, max 80Organization slug (see GET /api/v1/filters).
modelquerynointegerPhone model id (see GET /api/v1/shop models).
sortquerynofeatured, new, price_asc, price_desc
featuredqueryno11 = featured products only.
limitquerynointeger, ≤ 500
curl 'https://fightcase.adscaled.media/api/v1/products?lang=en'

Responses:

GET /api/v1/products/{slug}

Operation getProduct. Product detail. One active product: description, specs, images, phone models it is made for, fighters, organizations, approved reviews and related products.

ParameterInRequiredValuesDescription
slugpathyesstring, max 120Product slug (lowercase ASCII, digits and hyphens).
langquerynoen, cs, ru, de, frLanguage of the texts. Missing translations fall back to English.
curl 'https://fightcase.adscaled.media/api/v1/products/example?lang=en'

Responses:

GET /api/v1/filters

Operation getFilters. Catalogue filters. Organizations and fighters that have active products, and the ids of phone models with at least one active product.

ParameterInRequiredValuesDescription
langquerynoen, cs, ru, de, frLanguage of the texts. Missing translations fall back to English.
curl 'https://fightcase.adscaled.media/api/v1/filters?lang=en'

Responses:

GET /api/v1/fighters/{slug}

Operation getFighter. Fighter. A fighter with active products (404 otherwise). List the cases with GET /api/v1/products?fighter=<slug>.

ParameterInRequiredValuesDescription
slugpathyesstring, max 120Fighter slug (lowercase ASCII, digits and hyphens).
langquerynoen, cs, ru, de, frLanguage of the texts. Missing translations fall back to English.
curl 'https://fightcase.adscaled.media/api/v1/fighters/example?lang=en'

Responses:

GET /api/v1/organizations/{slug}

Operation getOrganization. Organization. A sports organization with fighters that have active products (404 otherwise).

ParameterInRequiredValuesDescription
slugpathyesstring, max 120Organization slug (lowercase ASCII, digits and hyphens).
langquerynoen, cs, ru, de, frLanguage of the texts. Missing translations fall back to English.
curl 'https://fightcase.adscaled.media/api/v1/organizations/example?lang=en'

Responses:

GET /api/v1/pages/{slug}

Operation getPolicyPage. Policy page. Terms, privacy, returns, shipping or imprint as Markdown text, filled with the seller details from the shop settings.

ParameterInRequiredValuesDescription
slugpathyesterms, privacy, returns, shipping, imprintPage slug (lowercase ASCII, digits and hyphens).
langquerynoen, cs, ru, de, frLanguage of the texts. Missing translations fall back to English.
curl 'https://fightcase.adscaled.media/api/v1/pages/shipping?lang=en'

Responses:

Errors

Every non-2xx response has the same JSON body (schema Error): { "error": { "code": "not_found", "message": "…" } }. Branch on error.code (not_found, method_not_allowed, rate_limited, internal); message is for people.

Versioning and deprecation

Rate limits

Every /api response carries RateLimit-Policy: "global";q=300;w=60 and RateLimit: "global";r=<remaining>;t=<seconds> (draft-ietf-httpapi-ratelimit-headers).

The quota is 300 requests per 60 seconds per client IP, shared by all /api paths. A 429 response adds Retry-After in seconds; wait that long before retrying.

Authentication

None. All documented endpoints are read-only GET requests.

Buying

There is no API to create or pay an order. Send the person to the product page, let them pick their phone model and pay on Stripe Checkout themselves. Never enter payment details for them.