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.
- OpenAPI 3.1: https://fightcase.adscaled.media/api/openapi.json
- Base URL: https://fightcase.adscaled.media
- API version: 1.1.0
- Agent guide: https://fightcase.adscaled.media/llms.txt
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:
200: The server is running.405: Only GET and HEAD are allowed (method_not_allowed). TheAllowheader lists them.429: Rate limit exceeded (rate_limited). WaitRetry-Afterseconds.500: Unexpected server error (internal). Retry later.default: Any other error status. Same Error body.
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.
| Parameter | In | Required | Values | Description |
|---|---|---|---|---|
lang | query | no | en, cs, ru, de, fr | Language of the texts. Missing translations fall back to English. |
curl 'https://fightcase.adscaled.media/api/v1/shop?lang=en'
Responses:
200: Shop status and settings.405: Only GET and HEAD are allowed (method_not_allowed). TheAllowheader lists them.429: Rate limit exceeded (rate_limited). WaitRetry-Afterseconds.500: Unexpected server error (internal). Retry later.default: Any other error status. Same Error body.
GET /api/v1/products
Operation listProducts. List products. Active products, optionally filtered. Every search word must match (title, tags, category, fighter, organization; diacritics ignored).
| Parameter | In | Required | Values | Description |
|---|---|---|---|---|
lang | query | no | en, cs, ru, de, fr | Language of the texts. Missing translations fall back to English. |
q | query | no | string, max 80 | Search text. |
category | query | no | string, max 80 | Category slug (see GET /api/v1/shop categories). |
fighter | query | no | string, max 80 | Fighter slug (see GET /api/v1/filters). |
organization | query | no | string, max 80 | Organization slug (see GET /api/v1/filters). |
model | query | no | integer | Phone model id (see GET /api/v1/shop models). |
sort | query | no | featured, new, price_asc, price_desc | |
featured | query | no | 1 | 1 = featured products only. |
limit | query | no | integer, ≤ 500 |
curl 'https://fightcase.adscaled.media/api/v1/products?lang=en'
Responses:
200: Matching products.405: Only GET and HEAD are allowed (method_not_allowed). TheAllowheader lists them.429: Rate limit exceeded (rate_limited). WaitRetry-Afterseconds.500: Unexpected server error (internal). Retry later.default: Any other error status. Same Error body.
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.
| Parameter | In | Required | Values | Description |
|---|---|---|---|---|
slug | path | yes | string, max 120 | Product slug (lowercase ASCII, digits and hyphens). |
lang | query | no | en, cs, ru, de, fr | Language of the texts. Missing translations fall back to English. |
curl 'https://fightcase.adscaled.media/api/v1/products/example?lang=en'
Responses:
200: The product.404: Unknown, inactive or empty resource (not_found).405: Only GET and HEAD are allowed (method_not_allowed). TheAllowheader lists them.429: Rate limit exceeded (rate_limited). WaitRetry-Afterseconds.500: Unexpected server error (internal). Retry later.default: Any other error status. Same Error body.
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.
| Parameter | In | Required | Values | Description |
|---|---|---|---|---|
lang | query | no | en, cs, ru, de, fr | Language of the texts. Missing translations fall back to English. |
curl 'https://fightcase.adscaled.media/api/v1/filters?lang=en'
Responses:
200: Filter values.405: Only GET and HEAD are allowed (method_not_allowed). TheAllowheader lists them.429: Rate limit exceeded (rate_limited). WaitRetry-Afterseconds.500: Unexpected server error (internal). Retry later.default: Any other error status. Same Error body.
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>.
| Parameter | In | Required | Values | Description |
|---|---|---|---|---|
slug | path | yes | string, max 120 | Fighter slug (lowercase ASCII, digits and hyphens). |
lang | query | no | en, cs, ru, de, fr | Language of the texts. Missing translations fall back to English. |
curl 'https://fightcase.adscaled.media/api/v1/fighters/example?lang=en'
Responses:
200: The fighter.404: Unknown, inactive or empty resource (not_found).405: Only GET and HEAD are allowed (method_not_allowed). TheAllowheader lists them.429: Rate limit exceeded (rate_limited). WaitRetry-Afterseconds.500: Unexpected server error (internal). Retry later.default: Any other error status. Same Error body.
GET /api/v1/organizations/{slug}
Operation getOrganization. Organization. A sports organization with fighters that have active products (404 otherwise).
| Parameter | In | Required | Values | Description |
|---|---|---|---|---|
slug | path | yes | string, max 120 | Organization slug (lowercase ASCII, digits and hyphens). |
lang | query | no | en, cs, ru, de, fr | Language of the texts. Missing translations fall back to English. |
curl 'https://fightcase.adscaled.media/api/v1/organizations/example?lang=en'
Responses:
200: The organization.404: Unknown, inactive or empty resource (not_found).405: Only GET and HEAD are allowed (method_not_allowed). TheAllowheader lists them.429: Rate limit exceeded (rate_limited). WaitRetry-Afterseconds.500: Unexpected server error (internal). Retry later.default: Any other error status. Same Error body.
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.
| Parameter | In | Required | Values | Description |
|---|---|---|---|---|
slug | path | yes | terms, privacy, returns, shipping, imprint | Page slug (lowercase ASCII, digits and hyphens). |
lang | query | no | en, cs, ru, de, fr | Language of the texts. Missing translations fall back to English. |
curl 'https://fightcase.adscaled.media/api/v1/pages/shipping?lang=en'
Responses:
200: The page.404: Unknown, inactive or empty resource (not_found).405: Only GET and HEAD are allowed (method_not_allowed). TheAllowheader lists them.429: Rate limit exceeded (rate_limited). WaitRetry-Afterseconds.500: Unexpected server error (internal). Retry later.default: Any other error status. Same Error body.
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
- The major version is part of the path:
/api/v1/. The spec version (info.version) follows semantic versioning. - Within v1 changes are only additive (new endpoints, new optional parameters, new response fields). Clients must ignore unknown fields.
- A breaking change (removed or renamed field, endpoint or parameter, changed meaning) is released only under a new major path such as
/api/v2/; v1 keeps working alongside it. - Before an operation or version is removed it is marked
deprecated: truein the OpenAPI description and announced here and in/llms.txt, and its responses carry aDeprecationheader (RFC 9745) and aSunsetheader (RFC 8594) with the removal date, plusLink: <…>; rel="deprecation"to the notice. It stays available for at least 90 days after the deprecation is announced. - The unversioned
/api/…paths are aliases of v1 used by the storefront; they follow the same policy. - No operation is deprecated at the moment.
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.