Skip to content

Order API ​

由 scripts/generate-api-docs.ts 自动生成 —— 请勿手改 共 6 个端点

GET /orgs/{organizationId}/orders ​

本组织的订单列表(最新在前)

请求参数 ​

参数名位置类型必填说明
organizationIdpathstring✅

响应 ​

状态码说明
200

POST /orgs/{organizationId}/orders ​

创建订单(buyer 取当前登录用户)

请求参数 ​

参数名位置类型必填说明
organizationIdpathstring✅

请求体 ​

json
{
  "$ref": "#/components/schemas/CreateOrderDto"
}

响应 ​

状态码说明
201

GET /orgs/{organizationId}/orders/{orderId} ​

订单详情(仅买家本人可读)

请求参数 ​

参数名位置类型必填说明
organizationIdpathstring✅
orderIdpathstring✅

响应 ​

状态码说明
200

GET /orgs/{organizationId}/orders/{orderId}/lines ​

订单行

请求参数 ​

参数名位置类型必填说明
organizationIdpathstring✅
orderIdpathstring✅

响应 ​

状态码说明
200

PATCH /orgs/{organizationId}/orders/{orderId}/status ​

订单状态迁移(乐观并发)

请求参数 ​

参数名位置类型必填说明
organizationIdpathstring✅
orderIdpathstring✅

请求体 ​

json
{
  "$ref": "#/components/schemas/UpdateOrderStatusDto"
}

响应 ​

状态码说明
200

GET /orgs/{organizationId}/orders/{orderId}/tasks ​

订单关联的履约任务指针(不含任务状态)

请求参数 ​

参数名位置类型必填说明
organizationIdpathstring✅
orderIdpathstring✅

响应 ​

状态码说明
200

Released under the MIT License.