GET /v1/orders/42
GET /v2/orders/42

app.MapGet("/v1/orders/{id}", (int id) =>
    Results.Ok(new { id, format = "v1" }));

app.MapGet("/v2/orders/{id}", (int id) =>
    Results.Ok(new { id, format = "v2",
        metadata = new { created_at = DateTime.UtcNow } }));

GET /orders/42?version=1

GET /orders/42 HTTP/1.1
X-CoffeeAPI-Version: 1

GET /v1/orders?user_id=42 HTTP/1.1
→
HTTP/1.1 200 OK
ETag: "rev1"

POST /v1/orders?user_id=42 HTTP/1.1
If-Match: "rev1"

{"recipe": "lungo"}
→
HTTP/1.1 201 Created
ETag: "rev2"

app.MapPost("/v1/orders",
    (OrderRequest req, HttpContext ctx) =>
{
    var ifMatch = ctx.Request.Headers
        .IfMatch.FirstOrDefault();

    var currentRevision = db.GetOrdersRevision(
        req.UserId);
    if (ifMatch is not null
        && ifMatch != $"\"{currentRevision}\"")
    {
        // Ревізія застаріла — дублікат не створюється
        return Results.StatusCode(412);
    }

    var order = db.CreateOrder(req);
    return Results.Created(
        $"/v1/orders/{order.Id}", order);
});

PUT /v1/orders/550e8400-e29b-41d4-a716-446655440000 HTTP/1.1

{"recipe": "lungo", "coffee_machine_id": 42}
→
HTTP/1.1 201 Created

app.MapPut("/v1/orders/{id}",
    (Guid id, OrderRequest req) =>
{
    if (db.OrderExists(id))
        return Results.Ok(db.GetOrder(id));

    var order = db.CreateOrder(id, req);
    return Results.Created(
        $"/v1/orders/{order.Id}", order);
});

POST /v1/orders/drafts HTTP/1.1

{"recipe": "lungo", "coffee_machine_id": 42}
→
HTTP/1.1 201 Created
Location: /v1/orders/drafts/abc-123

PUT /v1/orders/drafts/abc-123/commit HTTP/1.1
→
HTTP/1.1 201 Created
Location: /v1/orders/42

// Крок 1: чернетка (POST — неідемпотентний, але «легкий»)
app.MapPost("/v1/orders/drafts",
    (OrderDraft draft) =>
{
    var id = db.CreateDraft(draft);
    return Results.Created(
        $"/v1/orders/drafts/{id}",
        new { id });
});

// Крок 2: підтвердження (PUT — ідемпотентний!)
app.MapPut("/v1/orders/drafts/{id}/commit",
    (Guid id) =>
{
    var draft = db.GetDraft(id);
    if (draft is null)
        return Results.NotFound();

    // Вже підтверджена? Повертаємо замовлення
    if (draft.CommittedOrderId is not null)
        return Results.Ok(
            db.GetOrder(draft.CommittedOrderId.Value));

    var order = db.CommitDraft(id);
    return Results.Created(
        $"/v1/orders/{order.Id}", order);
});

// Змінити адресу доставки
app.MapPut("/v1/orders/{id}/address",
    (int id, AddressUpdate addr) =>
{
    var order = db.GetOrder(id);
    if (order is null) return Results.NotFound();

    db.UpdateOrderAddress(id, addr);
    return Results.Ok(new { id, address = addr });
});

// Змінити об'єм
app.MapPut("/v1/orders/{id}/volume",
    (int id, VolumeUpdate vol) =>
{
    var order = db.GetOrder(id);
    if (order is null) return Results.NotFound();

    db.UpdateOrderVolume(id, vol);
    return Results.Ok(new { id, volume = vol });
});

PATCH /v1/orders/42 HTTP/1.1
Content-Type: application/json

{"recipe": "americano"}
→
HTTP/1.1 200 OK
{"id": 42, "recipe": "americano", "volume": "350ml", ...}

app.MapPatch("/v1/orders/{id}",
    (int id, JsonElement patch) =>
{
    var order = db.GetOrder(id);
    if (order is null) return Results.NotFound();

    // Застосовуємо тільки передані поля
    if (patch.TryGetProperty("recipe", out var recipe))
        order.Recipe = recipe.GetString()!;
    if (patch.TryGetProperty("volume", out var volume))
        order.Volume = volume.GetString()!;

    db.SaveOrder(order);
    return Results.Ok(order);
});

// Крок 1: створити чернетку зі списком змін
app.MapPost("/v1/orders/{id}/drafts",
    (int id, ChangesDraft changes) =>
{
    var order = db.GetOrder(id);
    if (order is null) return Results.NotFound();

    var draftId = db.CreateChangesDraft(id, changes);
    return Results.Created(
        $"/v1/orders/{id}/drafts/{draftId}",
        new { id = draftId, changes });
});

// Крок 2: підтвердити чернетку (ідемпотентно!)
app.MapPut("/v1/orders/{id}/drafts/{draftId}/commit",
    (int id, Guid draftId) =>
{
    var draft = db.GetChangesDraft(draftId);
    if (draft is null) return Results.NotFound();

    // Вже підтверджена? Повертаємо результат
    if (draft.IsCommitted)
        return Results.Ok(db.GetOrder(id));

    var order = db.CommitChanges(id, draftId);
    return Results.Ok(order);
});