Order API
由
scripts/generate-api-docs.ts自动生成 —— 请勿手改 共 6 个端点
GET /orgs/{organizationId}/orders
本组织的订单列表(最新在前)
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
organizationId | path | string | ✅ |
响应
| 状态码 | 说明 |
|---|---|
| 200 |
POST /orgs/{organizationId}/orders
创建订单(buyer 取当前登录用户)
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
organizationId | path | string | ✅ |
请求体
json
{
"$ref": "#/components/schemas/CreateOrderDto"
}响应
| 状态码 | 说明 |
|---|---|
| 201 |
GET /orgs/{organizationId}/orders/{orderId}
订单详情(仅买家本人可读)
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
organizationId | path | string | ✅ | |
orderId | path | string | ✅ |
响应
| 状态码 | 说明 |
|---|---|
| 200 |
GET /orgs/{organizationId}/orders/{orderId}/lines
订单行
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
organizationId | path | string | ✅ | |
orderId | path | string | ✅ |
响应
| 状态码 | 说明 |
|---|---|
| 200 |
PATCH /orgs/{organizationId}/orders/{orderId}/status
订单状态迁移(乐观并发)
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
organizationId | path | string | ✅ | |
orderId | path | string | ✅ |
请求体
json
{
"$ref": "#/components/schemas/UpdateOrderStatusDto"
}响应
| 状态码 | 说明 |
|---|---|
| 200 |
GET /orgs/{organizationId}/orders/{orderId}/tasks
订单关联的履约任务指针(不含任务状态)
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
organizationId | path | string | ✅ | |
orderId | path | string | ✅ |
响应
| 状态码 | 说明 |
|---|---|
| 200 |