← Zurück

API Contract REST API Design

POST /orders

Headers:

• X-Api-Version: 2026-01
• Idempotency-Key: <stable-key>
• X-Correlation-Id: <trace-id>

Body im Lab-Format:

customer=C-100;lines=SKU-1,2,19.99|SKU-2,1,5.00

Responses:

• 201 Created mit Location und ETag
• 400 application/problem+json bei Validation Errors
• 406 application/problem+json bei falscher Version
• 409 bei wiederverwendetem Idempotency-Key mit anderem Payload

GET /orders/{id}

Responses:

• 200 OK mit ETag
• 404 bei unbekannter Order

PATCH /orders/{id}

Header:

• If-Match: <ETag>

Responses:

• 200 OK wenn Version passt
• 412 application/problem+json bei Versionskonflikt