{"openapi":"3.1.2","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"Vesremont Public API","version":"1.0.0","description":"Current store catalog and buyer-authorized shopping. OAuth Authorization Code with PKCE S256 is required for private state. Pass resource=https://vesremont.com/api/v1 during authorization and token exchange. Browser session cookies are not API credentials. All published warehouses are the store network; availability is not a delivery promise. API v1 adds fields compatibly; incompatible contracts require a new major version.","contact":{"name":"Vesremont","url":"https://vesremont.com/about/contacts/"}},"servers":[{"url":"https://vesremont.com/api/v1","description":"Production; no separate sandbox is advertised."}],"x-deprecation-policy":{"current_deprecated_operations":[],"minimum_notice_days":180,"breaking_changes":"New major API version. Existing v1 clients retain page/per_page and existing fields.","notification":"Publish migration documentation and emit Deprecation, Sunset (if scheduled) and Link on affected operations. No retirement is currently scheduled."},"x-pagination":{"mode":"signed-continuation","collections":["products","brands","product reviews"],"request":"Use pagination.next_cursor as cursor, keeping the same query filters/sort; omit page.","expires_seconds":900,"legacy_page_supported":true,"snapshot":false,"backend":"Existing offset-based search windows; this does not advertise keyset or snapshot isolation."},"tags":[{"name":"Catalog"},{"name":"Shopping"}],"paths":{"/status":{"get":{"operationId":"getStatus","summary":"Status","description":"Read API liveness, not dependency health. Public; no OAuth required. Read-only. HEAD is also supported and returns the same headers without a body.","tags":["Catalog"],"security":[],"parameters":[],"x-rate-limit-policy":"catalog","responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"ok"},"service":{"const":"vesremont-api"},"version":{"const":"1"}},"required":["status","service","version"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products":{"get":{"operationId":"searchProducts","summary":"Search Products","description":"Find current catalog products using the same search and filters as the storefront. Returns a bounded page with an exact total; narrow overly broad queries. Public; no OAuth required. Read-only. HEAD is also supported and returns the same headers without a body.","tags":["Catalog"],"security":[],"parameters":[{"name":"q","in":"query","required":false,"description":"Storefront text search query. Omit to browse the catalog with the supplied section, brand and filters.","schema":{"type":"string","maxLength":200,"description":"Storefront text search query. Omit to browse the catalog with the supplied section, brand and filters."}},{"name":"sort","in":"query","required":false,"description":"Catalog order: id_sort is the default ID order; price_min sorts cheapest first, price_max most expensive first.","schema":{"enum":["id_sort","price_min","price_max"],"description":"Catalog order: id_sort is the default ID order; price_min sorts cheapest first, price_max most expensive first."}},{"name":"page","in":"query","required":false,"description":"One-based result page, default 1. Do not combine with cursor; the existing offset window still applies.","schema":{"type":"integer","minimum":1,"maximum":100001,"description":"One-based result page, default 1. Do not combine with cursor; the existing offset window still applies."}},{"name":"per_page","in":"query","required":false,"description":"Maximum results per page, default 20. Keep the same value when following next_cursor.","schema":{"type":"integer","minimum":1,"maximum":100,"description":"Maximum results per page, default 20. Keep the same value when following next_cursor."}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from the previous response. Keep the same filters/sort; do not combine with page. Expires after 15 minutes. Existing backend windows apply; not a frozen snapshot.","schema":{"type":"string","maxLength":765,"description":"Opaque next_cursor from the previous response. Keep the same filters/sort; do not combine with page. Expires after 15 minutes. Existing backend windows apply; not a frozen snapshot."}},{"name":"section_id","in":"query","required":false,"description":"Restrict to this real catalog section. Do not combine with filters.section_ids.","schema":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Restrict to this real catalog section. Do not combine with filters.section_ids."}},{"name":"brand_id","in":"query","required":false,"description":"Restrict to this brand ID returned by search_brands or product data, not its display name.","schema":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Restrict to this brand ID returned by search_brands or product data, not its display name."}},{"name":"filters","in":"query","required":false,"description":"Storefront catalog filters. Combine with the current section/brand context; REST encodes this object as one JSON query value. One URL-encoded JSON object (maximum 4096 UTF-8 bytes), not bracket-style query parameters.","content":{"application/json":{"schema":{"type":"object","properties":{"section_ids":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647,"description":"One real catalog section ID, not a product or characteristic ID."},"minItems":1,"maxItems":20,"uniqueItems":true,"description":"Match any of these catalog sections (OR). Use real section IDs; do not combine with section_id."},"charats_id":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Selected characteristic value ID from get_catalog_filters, not the characteristic group ID."},"maxItems":20,"uniqueItems":true,"description":"Selected characteristic value IDs from contextual catalog filters. Do not invent IDs."},"range_id":{"type":"object","maxProperties":20,"propertyNames":{"pattern":"^(?:[2-9]|[1-9][0-9]{1,9})$"},"additionalProperties":{"type":"object","properties":{"min":{"type":"number","minimum":0,"maximum":9999999999.99,"multipleOf":0.01,"description":"Lower bound in the characteristic units returned by get_catalog_filters. Must not exceed max."},"max":{"type":"number","minimum":0,"maximum":9999999999.99,"multipleOf":0.01,"description":"Upper bound in the same characteristic units as min. Must not be below min."}},"required":["min","max"],"additionalProperties":false,"description":"Both bounds for one real numeric characteristic; use its returned range ID as the map key."},"description":"Map of numeric characteristic range IDs to min/max bounds. Use the numeric part of returned range:<id>; price uses price, not range ID 1."},"price":{"type":"object","properties":{"min":{"type":"number","minimum":0,"maximum":9999999999.99,"multipleOf":0.01,"description":"Minimum catalog unit price in RUB. Omit for no lower price restriction."},"max":{"type":"number","minimum":0,"maximum":9999999999.99,"multipleOf":0.01,"description":"Maximum catalog unit price in RUB. If supplied, it must be greater than zero and not below min."}},"required":[],"additionalProperties":false,"description":"Catalog unit-price bounds in RUB, not basket totals or delivery charges. Supply at least one bound.","minProperties":1}},"required":[],"additionalProperties":false,"description":"Storefront catalog filters. Combine with the current section/brand context; REST encodes this object as one JSON query value."}}}}],"x-rate-limit-policy":"search","responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"sku":{"type":"string","maxLength":150},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"description":{"type":"string","maxLength":4000},"images":{"type":"array","items":{"type":"string","format":"uri"}},"price":{"anyOf":[{"type":"object","properties":{"amount":{"type":"number","minimum":0},"currency":{"const":"RUB"},"old_amount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"discount_percent":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["amount","currency","old_amount","discount_percent"],"additionalProperties":false},{"type":"null"}]},"stock":{"type":"object","properties":{"local":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["local","total"],"additionalProperties":false,"description":"Both fields are the aggregate across the store warehouse network. They do not promise pickup today or a delivery lead time."},"requestable":{"type":"boolean"},"orderable":{"type":"boolean"},"availability":{"enum":["in_stock","backorder","preorder","out_of_stock","unavailable","unknown"]},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"brand":{"anyOf":[{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["id","name","url"],"additionalProperties":false},{"type":"null"}]},"section":{"anyOf":[{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["id","name","url"],"additionalProperties":false},{"type":"null"}]},"characteristics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","maxLength":150},"value":{"type":"string","maxLength":300}},"required":["id","name","value"],"additionalProperties":false}}},"required":["id","name","url","price","stock","orderable","availability","updated_at"],"additionalProperties":true}},"pagination":{"type":"object","properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total_items":{"type":"integer","minimum":0},"total_pages":{"type":"integer","minimum":0},"has_next":{"type":"boolean"},"has_prev":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string","maxLength":765},{"type":"null"}]}},"required":["page","per_page","total_items","total_pages","has_next","has_prev"],"additionalProperties":false}},"required":["items","pagination"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{product_id}":{"get":{"operationId":"getProduct","summary":"Get Product","description":"Read a current product, price, aggregate warehouse stock and public characteristics. Stock does not promise same-day pickup; unknown values remain null. Public; no OAuth required. Read-only. HEAD is also supported and returns the same headers without a body.","tags":["Catalog"],"security":[],"parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Internal numeric Vesremont product ID returned by catalog search or a product response, not the SKU/article or a basket item ID."},"description":"Internal numeric Vesremont product ID returned by catalog search or a product response, not the SKU/article or a basket item ID."}],"x-rate-limit-policy":"catalog","responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"sku":{"type":"string","maxLength":150},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"description":{"type":"string","maxLength":4000},"images":{"type":"array","items":{"type":"string","format":"uri"}},"price":{"anyOf":[{"type":"object","properties":{"amount":{"type":"number","minimum":0},"currency":{"const":"RUB"},"old_amount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"discount_percent":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["amount","currency","old_amount","discount_percent"],"additionalProperties":false},{"type":"null"}]},"stock":{"type":"object","properties":{"local":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["local","total"],"additionalProperties":false,"description":"Both fields are the aggregate across the store warehouse network. They do not promise pickup today or a delivery lead time."},"requestable":{"type":"boolean"},"orderable":{"type":"boolean"},"availability":{"enum":["in_stock","backorder","preorder","out_of_stock","unavailable","unknown"]},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"brand":{"anyOf":[{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["id","name","url"],"additionalProperties":false},{"type":"null"}]},"section":{"anyOf":[{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["id","name","url"],"additionalProperties":false},{"type":"null"}]},"characteristics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","maxLength":150},"value":{"type":"string","maxLength":300}},"required":["id","name","value"],"additionalProperties":false}}},"required":["id","name","url","price","stock","orderable","availability","updated_at"],"additionalProperties":true}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/brands":{"get":{"operationId":"searchBrands","summary":"Search Brands","description":"Find brands through the storefront brand search, including its typo suggestions. Returns paginated public brand links. Public; no OAuth required. Read-only. HEAD is also supported and returns the same headers without a body.","tags":["Catalog"],"security":[],"parameters":[{"name":"q","in":"query","required":false,"description":"Brand-name search query using the storefront brand search. Omit to browse public brands.","schema":{"type":"string","maxLength":200,"description":"Brand-name search query using the storefront brand search. Omit to browse public brands."}},{"name":"page","in":"query","required":false,"description":"One-based result page, default 1. Do not combine with cursor; the existing offset window still applies.","schema":{"type":"integer","minimum":1,"maximum":100001,"description":"One-based result page, default 1. Do not combine with cursor; the existing offset window still applies."}},{"name":"per_page","in":"query","required":false,"description":"Maximum results per page, default 20. Keep the same value when following next_cursor.","schema":{"type":"integer","minimum":1,"maximum":100,"description":"Maximum results per page, default 20. Keep the same value when following next_cursor."}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from the previous response. Keep the same filters/sort; do not combine with page. Expires after 15 minutes. Existing backend windows apply; not a frozen snapshot.","schema":{"type":"string","maxLength":765,"description":"Opaque next_cursor from the previous response. Keep the same filters/sort; do not combine with page. Expires after 15 minutes. Existing backend windows apply; not a frozen snapshot."}}],"x-rate-limit-policy":"search","responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["id","name","url"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total_items":{"type":"integer","minimum":0},"total_pages":{"type":"integer","minimum":0},"has_next":{"type":"boolean"},"has_prev":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string","maxLength":765},{"type":"null"}]}},"required":["page","per_page","total_items","total_pages","has_next","has_prev"],"additionalProperties":false}},"required":["items","pagination"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/catalog/filters":{"get":{"operationId":"getCatalogFilters","summary":"Get Catalog Filters","description":"Read real contextual catalog filters for a section or brand. Use returned IDs when searching; do not invent characteristic IDs. Public; no OAuth required. Read-only. HEAD is also supported and returns the same headers without a body. Specify at least section_id or brand_id.","tags":["Catalog"],"security":[],"parameters":[{"name":"section_id","in":"query","required":false,"description":"Restrict to this real catalog section. Do not combine with filters.section_ids.","schema":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Restrict to this real catalog section. Do not combine with filters.section_ids."}},{"name":"brand_id","in":"query","required":false,"description":"Restrict to this brand ID returned by search_brands or product data, not its display name.","schema":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Restrict to this brand ID returned by search_brands or product data, not its display name."}},{"name":"filters","in":"query","required":false,"description":"Storefront catalog filters. Combine with the current section/brand context; REST encodes this object as one JSON query value. One URL-encoded JSON object (maximum 4096 UTF-8 bytes), not bracket-style query parameters.","content":{"application/json":{"schema":{"type":"object","properties":{"section_ids":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647,"description":"One real catalog section ID, not a product or characteristic ID."},"minItems":1,"maxItems":20,"uniqueItems":true,"description":"Match any of these catalog sections (OR). Use real section IDs; do not combine with section_id."},"charats_id":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Selected characteristic value ID from get_catalog_filters, not the characteristic group ID."},"maxItems":20,"uniqueItems":true,"description":"Selected characteristic value IDs from contextual catalog filters. Do not invent IDs."},"range_id":{"type":"object","maxProperties":20,"propertyNames":{"pattern":"^(?:[2-9]|[1-9][0-9]{1,9})$"},"additionalProperties":{"type":"object","properties":{"min":{"type":"number","minimum":0,"maximum":9999999999.99,"multipleOf":0.01,"description":"Lower bound in the characteristic units returned by get_catalog_filters. Must not exceed max."},"max":{"type":"number","minimum":0,"maximum":9999999999.99,"multipleOf":0.01,"description":"Upper bound in the same characteristic units as min. Must not be below min."}},"required":["min","max"],"additionalProperties":false,"description":"Both bounds for one real numeric characteristic; use its returned range ID as the map key."},"description":"Map of numeric characteristic range IDs to min/max bounds. Use the numeric part of returned range:<id>; price uses price, not range ID 1."},"price":{"type":"object","properties":{"min":{"type":"number","minimum":0,"maximum":9999999999.99,"multipleOf":0.01,"description":"Minimum catalog unit price in RUB. Omit for no lower price restriction."},"max":{"type":"number","minimum":0,"maximum":9999999999.99,"multipleOf":0.01,"description":"Maximum catalog unit price in RUB. If supplied, it must be greater than zero and not below min."}},"required":[],"additionalProperties":false,"description":"Catalog unit-price bounds in RUB, not basket totals or delivery charges. Supply at least one bound.","minProperties":1}},"required":[],"additionalProperties":false,"description":"Storefront catalog filters. Combine with the current section/brand context; REST encodes this object as one JSON query value."}}}}],"x-rate-limit-policy":"search","responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"filters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"label":{"type":"string","maxLength":150},"type":{"enum":["select","range"]},"min":{"anyOf":[{"type":"number"},{"type":"null"}]},"max":{"anyOf":[{"type":"number"},{"type":"null"}]},"selected_min":{"anyOf":[{"type":"number"},{"type":"null"}]},"selected_max":{"anyOf":[{"type":"number"},{"type":"null"}]},"selected_values":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647}},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"label":{"type":"string","maxLength":300},"count":{"type":"integer","minimum":0},"selected":{"type":"boolean"}},"required":["id","label","count","selected"],"additionalProperties":false}}},"required":["id","code","label","type","min","max","selected_min","selected_max","selected_values","values"],"additionalProperties":false}},"context":{"type":"object","properties":{"section_id":{"anyOf":[{"type":"integer","minimum":1,"maximum":2147483647},{"type":"null"}]},"brand_id":{"anyOf":[{"type":"integer","minimum":1,"maximum":2147483647},{"type":"null"}]}},"required":["section_id","brand_id"],"additionalProperties":false}},"required":["filters","context"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/products/{product_id}/reviews":{"get":{"operationId":"getProductReviews","summary":"Get Product Reviews","description":"Read only moderated, published product reviews with real rating data and pagination. Public; no OAuth required. Read-only. HEAD is also supported and returns the same headers without a body.","tags":["Catalog"],"security":[],"parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Internal numeric Vesremont product ID returned by catalog search or a product response, not the SKU/article or a basket item ID."},"description":"Internal numeric Vesremont product ID returned by catalog search or a product response, not the SKU/article or a basket item ID."},{"name":"sort","in":"query","required":false,"description":"Published review order: newest first by default; choose date_asc for oldest first or rating_desc/rating_asc for highest/lowest ratings first.","schema":{"enum":["date_desc","date_asc","rating_desc","rating_asc"],"description":"Published review order: newest first by default; choose date_asc for oldest first or rating_desc/rating_asc for highest/lowest ratings first."}},{"name":"page","in":"query","required":false,"description":"One-based result page, default 1. Do not combine with cursor; the existing offset window still applies.","schema":{"type":"integer","minimum":1,"maximum":100001,"description":"One-based result page, default 1. Do not combine with cursor; the existing offset window still applies."}},{"name":"per_page","in":"query","required":false,"description":"Maximum results per page, default 20. Keep the same value when following next_cursor.","schema":{"type":"integer","minimum":1,"maximum":100,"description":"Maximum results per page, default 20. Keep the same value when following next_cursor."}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from the previous response. Keep the same filters/sort; do not combine with page. Expires after 15 minutes. Existing backend windows apply; not a frozen snapshot.","schema":{"type":"string","maxLength":765,"description":"Opaque next_cursor from the previous response. Keep the same filters/sort; do not combine with page. Expires after 15 minutes. Existing backend windows apply; not a frozen snapshot."}}],"x-rate-limit-policy":"catalog","responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"product_id":{"type":"integer","minimum":1,"maximum":2147483647},"rating":{"type":"integer","minimum":1,"maximum":5},"author_name":{"type":"string","maxLength":150},"pros":{"type":"string","maxLength":4000},"cons":{"type":"string","maxLength":4000},"text":{"type":"string","maxLength":8000},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["id","product_id","rating","author_name","pros","cons","text","published_at"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total_items":{"type":"integer","minimum":0},"total_pages":{"type":"integer","minimum":0},"has_next":{"type":"boolean"},"has_prev":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string","maxLength":765},{"type":"null"}]}},"required":["page","per_page","total_items","total_pages","has_next","has_prev"],"additionalProperties":false},"rating_summary":{"type":"object","properties":{"average_rating":{"anyOf":[{"type":"number","minimum":1,"maximum":5},{"type":"null"}]}},"required":["average_rating"],"additionalProperties":false}},"required":["items","pagination","rating_summary"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/cart":{"get":{"operationId":"getCart","summary":"Get Cart","description":"Read the consenting buyer's existing basket and recheck its current prices and stock. OAuth scopes: cart:read. Read-only. HEAD is also supported and returns the same headers without a body.","tags":["Shopping"],"security":[{"buyerOAuth":["cart:read"]}],"parameters":[],"x-rate-limit-policy":"read","responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"item_id":{"type":"integer","minimum":1,"maximum":2147483647},"product_id":{"type":"integer","minimum":0},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"quantity":{"type":"number"},"unit_price":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"line_total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"},"price_changed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"stock":{"type":"object","properties":{"local":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["local","total"],"additionalProperties":false,"description":"Both fields are the aggregate across the store warehouse network. They do not promise pickup today or a delivery lead time."},"availability":{"enum":["in_stock","backorder","preorder","out_of_stock","unavailable","unknown"]}},"required":["item_id","product_id","name","url","quantity","unit_price","line_total","currency","orderable","price_changed","stock","availability"],"additionalProperties":false}},"empty":{"type":"boolean"},"total_quantity":{"type":"number"},"subtotal":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"}},"required":["items","empty","total_quantity","subtotal","currency","orderable"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/cart/items":{"post":{"operationId":"addCartItem","summary":"Add Cart Item","description":"Add a product quantity to the consenting buyer's existing basket. Quantity is an increment; do not retry blindly or use this to create an order. OAuth scopes: cart:write. Changes buyer or order state. Requires a JSON object body; use {} for an operation without body fields.","tags":["Shopping"],"security":[{"buyerOAuth":["cart:write"]}],"parameters":[],"x-rate-limit-policy":"mutation","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Internal numeric Vesremont product ID returned by catalog search or a product response, not the SKU/article or a basket item ID."},"quantity":{"type":"integer","minimum":1,"maximum":99,"description":"Number of units to ADD to the existing basket quantity, not the desired final quantity. Do not blindly retry an uncertain add."}},"required":["product_id","quantity"],"additionalProperties":false}}}},"responses":{"201":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"item_id":{"type":"integer","minimum":1,"maximum":2147483647},"product_id":{"type":"integer","minimum":0},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"quantity":{"type":"number"},"unit_price":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"line_total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"},"price_changed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"stock":{"type":"object","properties":{"local":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["local","total"],"additionalProperties":false,"description":"Both fields are the aggregate across the store warehouse network. They do not promise pickup today or a delivery lead time."},"availability":{"enum":["in_stock","backorder","preorder","out_of_stock","unavailable","unknown"]}},"required":["item_id","product_id","name","url","quantity","unit_price","line_total","currency","orderable","price_changed","stock","availability"],"additionalProperties":false}},"empty":{"type":"boolean"},"total_quantity":{"type":"number"},"subtotal":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"}},"required":["items","empty","total_quantity","subtotal","currency","orderable"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/cart/items/{item_id}":{"patch":{"operationId":"updateCartItem","summary":"Update Cart Item","description":"Set the absolute quantity of an item in this buyer's basket. Quantity zero removes it. OAuth scopes: cart:write. Changes buyer or order state. Requires a JSON object body; use {} for an operation without body fields.","tags":["Shopping"],"security":[{"buyerOAuth":["cart:write"]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Basket line item_id from this consenting buyer's get_cart response, not product_id or another buyer's item."},"description":"Basket line item_id from this consenting buyer's get_cart response, not product_id or another buyer's item."}],"x-rate-limit-policy":"mutation","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quantity":{"type":"integer","minimum":0,"maximum":999,"description":"New ABSOLUTE quantity for this basket line, not an increment. Zero removes the line."}},"required":["quantity"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"item_id":{"type":"integer","minimum":1,"maximum":2147483647},"product_id":{"type":"integer","minimum":0},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"quantity":{"type":"number"},"unit_price":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"line_total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"},"price_changed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"stock":{"type":"object","properties":{"local":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["local","total"],"additionalProperties":false,"description":"Both fields are the aggregate across the store warehouse network. They do not promise pickup today or a delivery lead time."},"availability":{"enum":["in_stock","backorder","preorder","out_of_stock","unavailable","unknown"]}},"required":["item_id","product_id","name","url","quantity","unit_price","line_total","currency","orderable","price_changed","stock","availability"],"additionalProperties":false}},"empty":{"type":"boolean"},"total_quantity":{"type":"number"},"subtotal":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"}},"required":["items","empty","total_quantity","subtotal","currency","orderable"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"operationId":"removeCartItem","summary":"Remove Cart Item","description":"Remove an item owned by this buyer from their existing basket. OAuth scopes: cart:write. Changes buyer or order state.","tags":["Shopping"],"security":[{"buyerOAuth":["cart:write"]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Basket line item_id from this consenting buyer's get_cart response, not product_id or another buyer's item."},"description":"Basket line item_id from this consenting buyer's get_cart response, not product_id or another buyer's item."}],"x-rate-limit-policy":"mutation","responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"item_id":{"type":"integer","minimum":1,"maximum":2147483647},"product_id":{"type":"integer","minimum":0},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"quantity":{"type":"number"},"unit_price":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"line_total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"},"price_changed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"stock":{"type":"object","properties":{"local":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["local","total"],"additionalProperties":false,"description":"Both fields are the aggregate across the store warehouse network. They do not promise pickup today or a delivery lead time."},"availability":{"enum":["in_stock","backorder","preorder","out_of_stock","unavailable","unknown"]}},"required":["item_id","product_id","name","url","quantity","unit_price","line_total","currency","orderable","price_changed","stock","availability"],"additionalProperties":false}},"empty":{"type":"boolean"},"total_quantity":{"type":"number"},"subtotal":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"}},"required":["items","empty","total_quantity","subtotal","currency","orderable"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/favorites":{"get":{"operationId":"getFavorites","summary":"Get Favorites","description":"Read the consenting buyer's existing favorites. OAuth scopes: favorites:read. Read-only. HEAD is also supported and returns the same headers without a body.","tags":["Shopping"],"security":[{"buyerOAuth":["favorites:read"]}],"parameters":[],"x-rate-limit-policy":"read","responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"product_ids":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647}},"count":{"type":"integer","minimum":0},"empty":{"type":"boolean"}},"required":["product_ids","count","empty"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/favorites/items":{"post":{"operationId":"addFavorite","summary":"Add Favorite","description":"Add a current public product to this buyer's favorites. OAuth scopes: favorites:write. Changes buyer or order state. Requires a JSON object body; use {} for an operation without body fields.","tags":["Shopping"],"security":[{"buyerOAuth":["favorites:write"]}],"parameters":[],"x-rate-limit-policy":"mutation","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Internal numeric Vesremont product ID returned by catalog search or a product response, not the SKU/article or a basket item ID."}},"required":["product_id"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"product_ids":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647}},"count":{"type":"integer","minimum":0},"empty":{"type":"boolean"}},"required":["product_ids","count","empty"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/favorites/items/{product_id}":{"delete":{"operationId":"removeFavorite","summary":"Remove Favorite","description":"Remove a product from this buyer's favorites. OAuth scopes: favorites:write. Changes buyer or order state.","tags":["Shopping"],"security":[{"buyerOAuth":["favorites:write"]}],"parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Internal numeric Vesremont product ID returned by catalog search or a product response, not the SKU/article or a basket item ID."},"description":"Internal numeric Vesremont product ID returned by catalog search or a product response, not the SKU/article or a basket item ID."}],"x-rate-limit-policy":"mutation","responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"product_ids":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647}},"count":{"type":"integer","minimum":0},"empty":{"type":"boolean"}},"required":["product_ids","count","empty"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/checkout":{"get":{"operationId":"getCheckout","summary":"Get Checkout","description":"Read current checkout details, validation and available store options. Unquoted delivery and final totals stay null; no payment is made. OAuth scopes: checkout:read. Read-only. HEAD is also supported and returns the same headers without a body.","tags":["Shopping"],"security":[{"buyerOAuth":["checkout:read"]}],"parameters":[],"x-rate-limit-policy":"read","responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"cart":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"item_id":{"type":"integer","minimum":1,"maximum":2147483647},"product_id":{"type":"integer","minimum":0},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"quantity":{"type":"number"},"unit_price":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"line_total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"},"price_changed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"stock":{"type":"object","properties":{"local":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["local","total"],"additionalProperties":false,"description":"Both fields are the aggregate across the store warehouse network. They do not promise pickup today or a delivery lead time."},"availability":{"enum":["in_stock","backorder","preorder","out_of_stock","unavailable","unknown"]}},"required":["item_id","product_id","name","url","quantity","unit_price","line_total","currency","orderable","price_changed","stock","availability"],"additionalProperties":false}},"empty":{"type":"boolean"},"total_quantity":{"type":"number"},"subtotal":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"}},"required":["items","empty","total_quantity","subtotal","currency","orderable"],"additionalProperties":false},"customer":{"type":"object","properties":{"delivery":{"anyOf":[{"enum":["pickup","courier"]},{"type":"null"}]},"payment":{"anyOf":[{"enum":["cash","sbp","card","invoice"]},{"type":"null"}]},"address":{"type":"string","maxLength":4000},"name":{"type":"string","maxLength":200},"email":{"type":"string","maxLength":254},"phone":{"type":"string","maxLength":32},"comment":{"type":"string","maxLength":4000}},"required":["delivery","payment","address","name","email","phone","comment"],"additionalProperties":false},"quote":{"anyOf":[{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"item_id":{"type":"integer","minimum":1,"maximum":2147483647},"product_id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","maxLength":300},"quantity":{"type":"number","minimum":1},"unit_price":{"type":"number","minimum":0},"line_total":{"type":"number","minimum":0}},"required":["item_id","product_id","name","quantity","unit_price","line_total"],"additionalProperties":false}},"items_total":{"type":"number","minimum":0},"recorded_order_total":{"type":"number","minimum":0},"recorded_delivery":{"type":"number","minimum":0},"currency":{"const":"RUB"},"delivery_finalized":{"const":false}},"required":["items","items_total","recorded_order_total","recorded_delivery","currency","delivery_finalized"],"additionalProperties":false},{"type":"null"}]},"options":{"type":"object","properties":{"delivery":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","maxLength":150}},"required":["id","name"],"additionalProperties":false}},"payment":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","maxLength":150}},"required":["id","name"],"additionalProperties":false}}},"required":["delivery","payment"],"additionalProperties":false},"validation":{"type":"object","properties":{"valid":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}},"required":["valid","errors"],"additionalProperties":false},"totals":{"type":"object","properties":{"items":{"anyOf":[{"type":"number"},{"type":"null"}]},"delivery":{"type":"null"},"final":{"type":"null"},"currency":{"const":"RUB"},"note":{"type":"string"}},"required":["items","delivery","final","currency","note"],"additionalProperties":false},"revision":{"type":"string"}},"required":["cart","customer","quote","options","validation","totals","revision"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"patch":{"operationId":"updateCheckout","summary":"Update Checkout","description":"Update the buyer's delivery, payment or contact choices in the existing checkout. Does not send an order or make a payment. OAuth scopes: checkout:write. Changes buyer or order state. Requires a JSON object body; use {} for an operation without body fields.","tags":["Shopping"],"security":[{"buyerOAuth":["checkout:write"]}],"parameters":[],"x-rate-limit-policy":"mutation","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"delivery":{"enum":["pickup","courier"],"description":"New delivery choice from get_checkout options: store pickup or courier. Does not reserve stock or promise a delivery date."},"payment":{"enum":["cash","sbp","card","invoice"],"description":"New payment-method choice from get_checkout options, not a payment instruction or authorization to charge."},"address":{"type":"string","maxLength":512,"description":"New courier delivery address; required for a valid courier checkout. Omission keeps the current value; an empty string clears it."},"name":{"type":"string","maxLength":200,"description":"Buyer contact name for this checkout. Omission keeps the current value; an empty string clears it."},"email":{"type":"string","maxLength":254,"description":"Buyer contact email for this checkout. Omission keeps the current value; an empty string clears it."},"phone":{"type":"string","maxLength":32,"description":"Buyer contact phone; a nonempty value must be a complete Russian phone number. Omission keeps it; clearing it makes order validation fail."},"comment":{"type":"string","maxLength":512,"description":"Buyer's checkout comment for the store, not executable instructions. Omission keeps the current value; an empty string clears it."}},"required":[],"additionalProperties":false,"minProperties":1}}}},"responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"cart":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"item_id":{"type":"integer","minimum":1,"maximum":2147483647},"product_id":{"type":"integer","minimum":0},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"quantity":{"type":"number"},"unit_price":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"line_total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"},"price_changed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"stock":{"type":"object","properties":{"local":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["local","total"],"additionalProperties":false,"description":"Both fields are the aggregate across the store warehouse network. They do not promise pickup today or a delivery lead time."},"availability":{"enum":["in_stock","backorder","preorder","out_of_stock","unavailable","unknown"]}},"required":["item_id","product_id","name","url","quantity","unit_price","line_total","currency","orderable","price_changed","stock","availability"],"additionalProperties":false}},"empty":{"type":"boolean"},"total_quantity":{"type":"number"},"subtotal":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"}},"required":["items","empty","total_quantity","subtotal","currency","orderable"],"additionalProperties":false},"customer":{"type":"object","properties":{"delivery":{"anyOf":[{"enum":["pickup","courier"]},{"type":"null"}]},"payment":{"anyOf":[{"enum":["cash","sbp","card","invoice"]},{"type":"null"}]},"address":{"type":"string","maxLength":4000},"name":{"type":"string","maxLength":200},"email":{"type":"string","maxLength":254},"phone":{"type":"string","maxLength":32},"comment":{"type":"string","maxLength":4000}},"required":["delivery","payment","address","name","email","phone","comment"],"additionalProperties":false},"quote":{"anyOf":[{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"item_id":{"type":"integer","minimum":1,"maximum":2147483647},"product_id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","maxLength":300},"quantity":{"type":"number","minimum":1},"unit_price":{"type":"number","minimum":0},"line_total":{"type":"number","minimum":0}},"required":["item_id","product_id","name","quantity","unit_price","line_total"],"additionalProperties":false}},"items_total":{"type":"number","minimum":0},"recorded_order_total":{"type":"number","minimum":0},"recorded_delivery":{"type":"number","minimum":0},"currency":{"const":"RUB"},"delivery_finalized":{"const":false}},"required":["items","items_total","recorded_order_total","recorded_delivery","currency","delivery_finalized"],"additionalProperties":false},{"type":"null"}]},"options":{"type":"object","properties":{"delivery":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","maxLength":150}},"required":["id","name"],"additionalProperties":false}},"payment":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","maxLength":150}},"required":["id","name"],"additionalProperties":false}}},"required":["delivery","payment"],"additionalProperties":false},"validation":{"type":"object","properties":{"valid":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}},"required":["valid","errors"],"additionalProperties":false},"totals":{"type":"object","properties":{"items":{"anyOf":[{"type":"number"},{"type":"null"}]},"delivery":{"type":"null"},"final":{"type":"null"},"currency":{"const":"RUB"},"note":{"type":"string"}},"required":["items","delivery","final","currency","note"],"additionalProperties":false},"revision":{"type":"string"}},"required":["cart","customer","quote","options","validation","totals","revision"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/orders/prepare":{"post":{"operationId":"prepareOrder","summary":"Prepare Order","description":"Prepare an exact current order summary and a short-lived browser confirmation link. The buyer must personally approve that summary; this does not submit it. OAuth scopes: order:prepare. Changes buyer or order state. Requires a JSON object body; use {} for an operation without body fields.","tags":["Shopping"],"security":[{"buyerOAuth":["order:prepare"]}],"parameters":[],"x-rate-limit-policy":"submit","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"awaiting_user_confirmation"},"confirmation_token":{"type":"string"},"confirmation_url":{"type":"string","format":"uri"},"expires_at":{"type":"string","format":"date-time"},"cart_revision":{"type":"string"},"summary":{"type":"object","properties":{"cart":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"item_id":{"type":"integer","minimum":1,"maximum":2147483647},"product_id":{"type":"integer","minimum":0},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"quantity":{"type":"number"},"unit_price":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"line_total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"},"price_changed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"stock":{"type":"object","properties":{"local":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["local","total"],"additionalProperties":false,"description":"Both fields are the aggregate across the store warehouse network. They do not promise pickup today or a delivery lead time."},"availability":{"enum":["in_stock","backorder","preorder","out_of_stock","unavailable","unknown"]}},"required":["item_id","product_id","name","url","quantity","unit_price","line_total","currency","orderable","price_changed","stock","availability"],"additionalProperties":false}},"empty":{"type":"boolean"},"total_quantity":{"type":"number"},"subtotal":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"}},"required":["items","empty","total_quantity","subtotal","currency","orderable"],"additionalProperties":false},"customer":{"type":"object","properties":{"delivery":{"anyOf":[{"enum":["pickup","courier"]},{"type":"null"}]},"payment":{"anyOf":[{"enum":["cash","sbp","card","invoice"]},{"type":"null"}]},"address":{"type":"string","maxLength":4000},"name":{"type":"string","maxLength":200},"email":{"type":"string","maxLength":254},"phone":{"type":"string","maxLength":32},"comment":{"type":"string","maxLength":4000}},"required":["delivery","payment","address","name","email","phone","comment"],"additionalProperties":false},"quote":{"anyOf":[{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"item_id":{"type":"integer","minimum":1,"maximum":2147483647},"product_id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","maxLength":300},"quantity":{"type":"number","minimum":1},"unit_price":{"type":"number","minimum":0},"line_total":{"type":"number","minimum":0}},"required":["item_id","product_id","name","quantity","unit_price","line_total"],"additionalProperties":false}},"items_total":{"type":"number","minimum":0},"recorded_order_total":{"type":"number","minimum":0},"recorded_delivery":{"type":"number","minimum":0},"currency":{"const":"RUB"},"delivery_finalized":{"const":false}},"required":["items","items_total","recorded_order_total","recorded_delivery","currency","delivery_finalized"],"additionalProperties":false},{"type":"null"}]},"options":{"type":"object","properties":{"delivery":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","maxLength":150}},"required":["id","name"],"additionalProperties":false}},"payment":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","maxLength":150}},"required":["id","name"],"additionalProperties":false}}},"required":["delivery","payment"],"additionalProperties":false},"validation":{"type":"object","properties":{"valid":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}},"required":["valid","errors"],"additionalProperties":false},"totals":{"type":"object","properties":{"items":{"anyOf":[{"type":"number"},{"type":"null"}]},"delivery":{"type":"null"},"final":{"type":"null"},"currency":{"const":"RUB"},"note":{"type":"string"}},"required":["items","delivery","final","currency","note"],"additionalProperties":false},"revision":{"type":"string"}},"required":["cart","customer","quote","options","validation","totals","revision"],"additionalProperties":false}},"required":["status","confirmation_token","confirmation_url","expires_at","cart_revision","summary"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/orders/submit":{"post":{"operationId":"submitOrder","summary":"Submit Order","description":"Submit only an order already approved by the buyer in the confirmation page. Requires the returned token and a stable unique idempotency_key; retry the same key after uncertainty. Never bypass confirmation. OAuth scopes: order:submit. Changes buyer or order state. Requires a JSON object body; use {} for an operation without body fields.","tags":["Shopping"],"security":[{"buyerOAuth":["order:submit"]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{16,128}$","description":"Unique key for ONE approved submission. Keep this key and the same body for retries after uncertainty; never generate a new key to retry that order. REST sends it as Idempotency-Key."},"description":"Keep this key and the exact body for retries. A changed body with the same key conflicts. Never retry an uncertain submission with a new key."}],"x-rate-limit-policy":"submit","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"confirmation_token":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Token returned by prepare_order for the exact summary the buyer personally approved on the confirmation page. It cannot replace that approval."}},"required":["confirmation_token"],"additionalProperties":false}}}},"responses":{"201":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"order_id":{"type":"integer","minimum":1,"maximum":2147483647},"submission_status":{"const":"submitted"},"status":{"type":"string","description":"Actual Bitrix status code; submitted is not store confirmation."},"cancelled":{"type":"boolean"},"payment_status":{"enum":["paid","partially_paid","unpaid"]},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status_history":{"type":"null"},"summary":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"integer","minimum":0},"name":{"type":"string","maxLength":300},"quantity":{"type":"number"},"unit_price":{"type":"number"},"line_total":{"type":"number"}},"required":["product_id","name","quantity","unit_price","line_total"],"additionalProperties":false}},"recorded_order_total":{"type":"number"},"currency":{"type":"string"},"delivery_finalized":{"type":"null"},"store_confirmation":{"type":"null"}},"required":["items","recorded_order_total","currency","delivery_finalized","store_confirmation"],"additionalProperties":false}},"required":["order_id","submission_status","status","cancelled","payment_status","created_at","updated_at","summary","status_history"],"additionalProperties":false}}}},"202":{"description":"Submission result is still being reconciled. Retry only with the original key and body.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"processing"},"operation_id":{"type":"string"},"message":{"type":"string"}},"required":["status","operation_id","message"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/orders/{order_id}":{"get":{"operationId":"getOrder","summary":"Get Order","description":"Read an order created by this application for the same buyer session, including after reauthorization. Saving means submitted, not confirmed by the store; unavailable history or confirmation data remain null. OAuth scopes: orders:read. Read-only. HEAD is also supported and returns the same headers without a body.","tags":["Shopping"],"security":[{"buyerOAuth":["orders:read"]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":2147483647,"description":"Order ID returned by this application's successful submission for the same buyer session; not an arbitrary store order."},"description":"Order ID returned by this application's successful submission for the same buyer session; not an arbitrary store order."}],"x-rate-limit-policy":"read","responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"order_id":{"type":"integer","minimum":1,"maximum":2147483647},"submission_status":{"const":"submitted"},"status":{"type":"string","description":"Actual Bitrix status code; submitted is not store confirmation."},"cancelled":{"type":"boolean"},"payment_status":{"enum":["paid","partially_paid","unpaid"]},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status_history":{"type":"null"},"summary":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"integer","minimum":0},"name":{"type":"string","maxLength":300},"quantity":{"type":"number"},"unit_price":{"type":"number"},"line_total":{"type":"number"}},"required":["product_id","name","quantity","unit_price","line_total"],"additionalProperties":false}},"recorded_order_total":{"type":"number"},"currency":{"type":"string"},"delivery_finalized":{"type":"null"},"store_confirmation":{"type":"null"}},"required":["items","recorded_order_total","currency","delivery_finalized","store_confirmation"],"additionalProperties":false}},"required":["order_id","submission_status","status","cancelled","payment_status","created_at","updated_at","summary","status_history"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/webhooks":{"get":{"operationId":"listWebhooks","summary":"List Webhooks","description":"List this application and buyer session's order event subscriptions. Signing secrets are never returned again. OAuth scopes: webhooks:read. Read-only. HEAD is also supported and returns the same headers without a body.","tags":["Shopping"],"security":[{"buyerOAuth":["webhooks:read"]}],"parameters":[],"x-rate-limit-policy":"read","responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-f0-9]{32}$"},"callback_url":{"type":"string","format":"uri"},"events":{"type":"array","items":{"enum":["order.status_changed","order.cancelled","payment.status_changed"]}},"status":{"enum":["pending","active","deleted","failed","expired"]},"requires_active_grant":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"}},"required":["id","callback_url","events","status","requires_active_grant","created_at","updated_at","expires_at"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"post":{"operationId":"createWebhook","summary":"Create Webhook","description":"Create a pending order event subscription to a public HTTPS receiver. Returns its signing secret ONCE. The receiver must echo the signed verification challenge before activation. No customer contact fields are sent. Check expires_at and requires_active_grant. OAuth scopes: webhooks:write, orders:read. Changes buyer or order state. Requires a JSON object body; use {} for an operation without body fields.","tags":["Shopping"],"security":[{"buyerOAuth":["webhooks:write","orders:read"]}],"parameters":[],"x-rate-limit-policy":"webhook","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"callback_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048,"description":"Public HTTPS receiver under your control for signed verification and order events. Private-network, credential-bearing and unsafe receiver URLs are rejected; echo the signed challenge to activate."},"events":{"type":"array","items":{"enum":["order.status_changed","order.cancelled","payment.status_changed"],"description":"One order event category: order status transition, cancellation, or payment-status transition."},"minItems":1,"maxItems":3,"uniqueItems":true,"description":"Distinct order event categories to subscribe to for this application and consenting buyer session. No customer contact fields are included."}},"required":["callback_url","events"],"additionalProperties":false}}}},"responses":{"201":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-f0-9]{32}$"},"callback_url":{"type":"string","format":"uri"},"events":{"type":"array","items":{"enum":["order.status_changed","order.cancelled","payment.status_changed"]}},"status":{"enum":["pending","active","deleted","failed","expired"]},"requires_active_grant":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"},"signing_secret":{"type":"string","pattern":"^whsec_[A-Za-z0-9+/]{43}=$"}},"required":["id","callback_url","events","status","requires_active_grant","created_at","updated_at","expires_at","signing_secret"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/webhooks/{subscription_id}":{"delete":{"operationId":"deleteWebhook","summary":"Delete Webhook","description":"Revoke an owned order event subscription and cancel queued deliveries. An already in-flight HTTPS request cannot be recalled. OAuth scopes: webhooks:write. Changes buyer or order state.","tags":["Shopping"],"security":[{"buyerOAuth":["webhooks:write"]}],"parameters":[{"name":"subscription_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{32}$","description":"Subscription ID returned by create_webhook or list_webhooks for this application and buyer session. Not a delivery ID or signing secret."},"description":"Subscription ID returned by create_webhook or list_webhooks for this application and buyer session. Not a delivery ID or signing secret."}],"x-rate-limit-policy":"webhook","responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-f0-9]{32}$"},"status":{"const":"deleted"}},"required":["id","status"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/webhooks/{subscription_id}/deliveries":{"get":{"operationId":"listWebhookDeliveries","summary":"List Webhook Deliveries","description":"Read the latest 100 delivery attempts for an owned subscription, without event payloads or secrets. OAuth scopes: webhooks:read. Read-only. HEAD is also supported and returns the same headers without a body.","tags":["Shopping"],"security":[{"buyerOAuth":["webhooks:read"]}],"parameters":[{"name":"subscription_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{32}$","description":"Subscription ID returned by create_webhook or list_webhooks for this application and buyer session. Not a delivery ID or signing secret."},"description":"Subscription ID returned by create_webhook or list_webhooks for this application and buyer session. Not a delivery ID or signing secret."}],"x-rate-limit-policy":"read","responses":{"200":{"description":"Successful operation.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."}},"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"event_id":{"type":"string"},"event_type":{"type":"string"},"attempt":{"type":"integer","minimum":0},"http_status":{"anyOf":[{"type":"integer"},{"type":"null"}]},"status":{"enum":["queued","sending","delivered","failed","cancelled"]},"next_retry_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"delivered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["event_id","event_type","attempt","http_status","status","next_retry_at","delivered_at"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"400":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"406":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"414":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"431":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}},"components":{"schemas":{"Problem":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"request_id":{"type":"string"}},"required":["type","status","code","request_id"],"additionalProperties":true},"Product":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"sku":{"type":"string","maxLength":150},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"description":{"type":"string","maxLength":4000},"images":{"type":"array","items":{"type":"string","format":"uri"}},"price":{"anyOf":[{"type":"object","properties":{"amount":{"type":"number","minimum":0},"currency":{"const":"RUB"},"old_amount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"discount_percent":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["amount","currency","old_amount","discount_percent"],"additionalProperties":false},{"type":"null"}]},"stock":{"type":"object","properties":{"local":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["local","total"],"additionalProperties":false,"description":"Both fields are the aggregate across the store warehouse network. They do not promise pickup today or a delivery lead time."},"requestable":{"type":"boolean"},"orderable":{"type":"boolean"},"availability":{"enum":["in_stock","backorder","preorder","out_of_stock","unavailable","unknown"]},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"brand":{"anyOf":[{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["id","name","url"],"additionalProperties":false},{"type":"null"}]},"section":{"anyOf":[{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["id","name","url"],"additionalProperties":false},{"type":"null"}]},"characteristics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","maxLength":150},"value":{"type":"string","maxLength":300}},"required":["id","name","value"],"additionalProperties":false}}},"required":["id","name","url","price","stock","orderable","availability","updated_at"],"additionalProperties":true},"Cart":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"item_id":{"type":"integer","minimum":1,"maximum":2147483647},"product_id":{"type":"integer","minimum":0},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"quantity":{"type":"number"},"unit_price":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"line_total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"},"price_changed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"stock":{"type":"object","properties":{"local":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["local","total"],"additionalProperties":false,"description":"Both fields are the aggregate across the store warehouse network. They do not promise pickup today or a delivery lead time."},"availability":{"enum":["in_stock","backorder","preorder","out_of_stock","unavailable","unknown"]}},"required":["item_id","product_id","name","url","quantity","unit_price","line_total","currency","orderable","price_changed","stock","availability"],"additionalProperties":false}},"empty":{"type":"boolean"},"total_quantity":{"type":"number"},"subtotal":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"}},"required":["items","empty","total_quantity","subtotal","currency","orderable"],"additionalProperties":false},"Checkout":{"type":"object","properties":{"cart":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"item_id":{"type":"integer","minimum":1,"maximum":2147483647},"product_id":{"type":"integer","minimum":0},"name":{"type":"string","maxLength":300},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"quantity":{"type":"number"},"unit_price":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"line_total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"},"price_changed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"stock":{"type":"object","properties":{"local":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"total":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["local","total"],"additionalProperties":false,"description":"Both fields are the aggregate across the store warehouse network. They do not promise pickup today or a delivery lead time."},"availability":{"enum":["in_stock","backorder","preorder","out_of_stock","unavailable","unknown"]}},"required":["item_id","product_id","name","url","quantity","unit_price","line_total","currency","orderable","price_changed","stock","availability"],"additionalProperties":false}},"empty":{"type":"boolean"},"total_quantity":{"type":"number"},"subtotal":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"const":"RUB"},"orderable":{"type":"boolean"}},"required":["items","empty","total_quantity","subtotal","currency","orderable"],"additionalProperties":false},"customer":{"type":"object","properties":{"delivery":{"anyOf":[{"enum":["pickup","courier"]},{"type":"null"}]},"payment":{"anyOf":[{"enum":["cash","sbp","card","invoice"]},{"type":"null"}]},"address":{"type":"string","maxLength":4000},"name":{"type":"string","maxLength":200},"email":{"type":"string","maxLength":254},"phone":{"type":"string","maxLength":32},"comment":{"type":"string","maxLength":4000}},"required":["delivery","payment","address","name","email","phone","comment"],"additionalProperties":false},"quote":{"anyOf":[{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"item_id":{"type":"integer","minimum":1,"maximum":2147483647},"product_id":{"type":"integer","minimum":1,"maximum":2147483647},"name":{"type":"string","maxLength":300},"quantity":{"type":"number","minimum":1},"unit_price":{"type":"number","minimum":0},"line_total":{"type":"number","minimum":0}},"required":["item_id","product_id","name","quantity","unit_price","line_total"],"additionalProperties":false}},"items_total":{"type":"number","minimum":0},"recorded_order_total":{"type":"number","minimum":0},"recorded_delivery":{"type":"number","minimum":0},"currency":{"const":"RUB"},"delivery_finalized":{"const":false}},"required":["items","items_total","recorded_order_total","recorded_delivery","currency","delivery_finalized"],"additionalProperties":false},{"type":"null"}]},"options":{"type":"object","properties":{"delivery":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","maxLength":150}},"required":["id","name"],"additionalProperties":false}},"payment":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","maxLength":150}},"required":["id","name"],"additionalProperties":false}}},"required":["delivery","payment"],"additionalProperties":false},"validation":{"type":"object","properties":{"valid":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}},"required":["valid","errors"],"additionalProperties":false},"totals":{"type":"object","properties":{"items":{"anyOf":[{"type":"number"},{"type":"null"}]},"delivery":{"type":"null"},"final":{"type":"null"},"currency":{"const":"RUB"},"note":{"type":"string"}},"required":["items","delivery","final","currency","note"],"additionalProperties":false},"revision":{"type":"string"}},"required":["cart","customer","quote","options","validation","totals","revision"],"additionalProperties":false},"Order":{"type":"object","properties":{"order_id":{"type":"integer","minimum":1,"maximum":2147483647},"submission_status":{"const":"submitted"},"status":{"type":"string","description":"Actual Bitrix status code; submitted is not store confirmation."},"cancelled":{"type":"boolean"},"payment_status":{"enum":["paid","partially_paid","unpaid"]},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"status_history":{"type":"null"},"summary":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"integer","minimum":0},"name":{"type":"string","maxLength":300},"quantity":{"type":"number"},"unit_price":{"type":"number"},"line_total":{"type":"number"}},"required":["product_id","name","quantity","unit_price","line_total"],"additionalProperties":false}},"recorded_order_total":{"type":"number"},"currency":{"type":"string"},"delivery_finalized":{"type":"null"},"store_confirmation":{"type":"null"}},"required":["items","recorded_order_total","currency","delivery_finalized","store_confirmation"],"additionalProperties":false}},"required":["order_id","submission_status","status","cancelled","payment_status","created_at","updated_at","summary","status_history"],"additionalProperties":false}},"responses":{"Problem":{"description":"Structured failure. The code is stable; do not retry uncertain order writes with a new key.","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Opaque request correlation ID."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"IETF structured policy: policy name, quota q and window w in seconds."},"RateLimit":{"schema":{"type":"string"},"description":"IETF structured limit: remaining r and relative window t in seconds. Advisory, not reserved capacity."},"RateLimit-Limit":{"schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"schema":{"type":"integer","minimum":1},"description":"Relative seconds, NOT the legacy Unix timestamp. Early rejections may omit rate headers."},"X-RateLimit-Limit":{"schema":{"type":"integer","minimum":1},"description":"Emitted when the request reaches the enforced rate-limit policy. Early edge/auth rejection may omit these headers."},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Window reset time in Unix seconds."},"Deprecation":{"schema":{"type":"string","pattern":"^@[0-9]+$"},"description":"Structured date, only on an actually deprecated operation. None are currently deprecated."},"Sunset":{"schema":{"type":"string"},"description":"HTTP date, only when a deprecated operation has a scheduled removal."},"Link":{"schema":{"type":"string"},"description":"Deprecation/migration documentation link when applicable."},"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge with protected-resource metadata on authentication failures."},"Retry-After":{"schema":{"type":"integer"},"description":"Minimum delay in seconds where supplied."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"securitySchemes":{"buyerOAuth":{"type":"oauth2","description":"Authorization Code, mandatory PKCE S256, exact registered/CIMD redirect URI, resource-bound access token; no password grant.","flows":{"authorizationCode":{"authorizationUrl":"https://vesremont.com/oauth/authorize","tokenUrl":"https://vesremont.com/oauth/token","scopes":{"cart:read":"Чтение корзины","cart:write":"Изменение корзины","favorites:read":"Чтение избранного","favorites:write":"Изменение избранного","checkout:read":"Чтение данных оформления","checkout:write":"Изменение данных оформления","order:prepare":"Подготовка заказа","order:submit":"Отправка заказа после отдельного подтверждения","orders:read":"Чтение заказов этого приложения в текущей покупательской сессии","webhooks:read":"Чтение подписок на события","webhooks:write":"Изменение подписок на события"}}}}}},"externalDocs":{"url":"https://vesremont.com/developers/","description":"Vesremont developer documentation"}}