{
"openapi": "3.0.0",
"info": {
"title": "Orders Service API",
"version": "1.0.0"
},
"tags": [
{
"name": "orders",
"description": "Order management operations"
},
{
"name": "shipments",
"description": "Shipment operations"
}
],
"paths": {
"/orders": {
"get": {
"tags": ["orders"],
"summary": "List orders",
"operationId": "listOrders",
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Order"
}
}
}
}
}
}
}
},
"/orders/{id}": {
"get": {
"tags": ["orders"],
"summary": "Get order",
"operationId": "getOrder",
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Order"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"Order": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"total": {
"type": "number"
},
"status": {
"type": "string",
"enum": ["pending", "processing", "shipped", "delivered"]
}
},
"required": ["id", "total"]
}
}
}
}