Endpoint 目录
创建服务端重算的托管结账会话
POST /api/v1/open/hosted/checkout/sessions
POST /api/v1/open/hosted/checkout/sessions
- operationId:
createHostedCheckoutSession - 稳定性: stable
- 认证:
Authorizationheader API Key；所需 scope：catalog:read - 幂等: required
参数
此操作没有声明参数。
请求体
- 必需: 是
- Schema:
#/components/schemas/HostedCheckoutCreateRequest
响应与错误
| 状态 | 说明 | Schema |
|---|---|---|
200 | 操作成功 | #/components/schemas/HostedCheckoutSessionResponse |
400 | 请求不符合公开契约 | #/components/schemas/PublicErrorResponse |
401 | 认证失败 | #/components/schemas/PublicErrorResponse |
403 | 授权 scope 不足 | #/components/schemas/PublicErrorResponse |
404 | 公开资源不存在 | #/components/schemas/PublicErrorResponse |
409 | 幂等或状态冲突 | #/components/schemas/PublicErrorResponse |
429 | 请求频率受限 | #/components/schemas/PublicErrorResponse |
限流
spec 声明了 429 响应。
Retry-After header 未在 spec 中声明。
- 顶层结构:
{ data: object }
成功响应 Schema
{
"$ref": "#/components/schemas/HostedCheckoutSessionResponse"
}
错误响应 Schema
{
"$ref": "#/components/schemas/PublicErrorResponse"
}
本页由已验证 public-only OpenAPI artifact 生成；未提供推测性请求示例。