Панель, API и поставка — в одной документации.

curl --fail-with-body https://api.example.com/api/v1

{
  "name": "foundry-public-api",
  "version": "v1",
  "openapi": "/api/v1/openapi.json",
  "authentication": { "headers": ["Authorization", "X-API-Key"] },
  "resources": { "catalog": { "method": "GET", "path": "/api/v1/catalog" } }
}

curl --fail-with-body https://api.example.com/api/v1/health

{
  "status": "ok",
  "service": "foundry-public-api",
  "version": "v1",
  "timestamp": "2026-08-09T12:00:00.000Z"
}

curl --fail-with-body https://api.example.com/api/v1/openapi.json > furazhir.openapi.json

{
  "openapi": "3.1.0",
  "info": { "title": "Фуражир Public API", "version": "v1" },
  "paths": { "/api/v1/catalog": {}, "/api/v1/orders": {} }
}

curl --fail-with-body \
  -H "Authorization: Bearer $FOUNDRY_API_KEY" \
  "https://api.example.com/api/v1/catalog?available=1&sort=featured&page=1"

{
  "catalog": {
    "sections": [],
    "brands": [],
    "attributeFacets": [],
    "matchedProducts": 0,
    "totalProducts": 0
  }
}

curl --fail-with-body \
  -H "Authorization: Bearer $FOUNDRY_API_KEY" \
  "https://api.example.com/api/v1/content?scope=storefront"

{
  "entries": [
    { "id": "hero", "scope": "storefront", "title": "…", "body": "…", "position": 1 }
  ]
}

curl --fail-with-body \
  -H "Authorization: Bearer $FOUNDRY_API_KEY" \
  "https://api.example.com/api/v1/search?q=winter%20boots&limit=10"

{
  "items": [
    { "title": "Winter boots", "meta": "…", "href": "/catalog/boots", "type": "product" }
  ]
}

curl --fail-with-body -X POST \
  -H "Authorization: Bearer $FOUNDRY_API_KEY" \
  -H "Idempotency-Key: 01JEXAMPLEORDER000000000000000001" \
  -H "Content-Type: application/json" \
  --data '{"customerName":"Ada Lovelace","customerEmail":"ada@example.com","customerContact":"+10000000000","deliveryId":"pickup","pickupLocationId":"pickup-main","paymentId":"card","termsAccepted":true,"itemCount":1,"totalValue":12000,"items":[{"productId":"boots-1","productName":"Winter boots","quantity":1,"priceValue":12000}]}' \
  https://api.example.com/api/v1/orders

{
  "order": {
    "id": "order-…",
    "status": "new",
    "itemCount": 1,
    "totalValue": 12000
  }
}