Platform API — carts and orders

Read fleet-platform-api. Mutations need WRITE. Carts use order_id in the path (cart state is still an order).

Headers

• Authorization: Bearer <secret>
• Content-Type: application/json on POST / PATCH / validate

Response ideas

• List carts / list orders: { "data": [ … ], "meta" }
• Get cart / patch cart: { "data": { … } }
• Create cart: 201 { "data": { "order_id" } }
• Validate: { "data": { "order_id", "client_status" } }
• Get order: rich read model — fields in OpenAPI

Create cart body (concepts)