app.MapPut("/v1/orders/{id}", (Guid id, OrderRequest req) =>
{
    // URL = ключ ідемпотентності
    // Повторний PUT з тим самим ID → та сама дія
    if (db.OrderExists(id))
    {
        // Замовлення вже існує — повертаємо його
        return Results.Ok(db.GetOrder(id));
    }

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

// Клієнт генерує UUID:
// PUT /v1/orders/550e8400-e29b-41d4-a716-446655440000
// Повторний виклик — безпечний!

app.MapPost("/v1/orders", 
    (OrderRequest req, HttpContext ctx) =>
{
    // Клієнт передає унікальний ключ
    var idempotencyKey = ctx.Request.Headers[
        "X-Idempotency-Key"].FirstOrDefault();

    if (string.IsNullOrEmpty(idempotencyKey))
        return Results.Json(
            new { error = "X-Idempotency-Key required" },
            statusCode: 428);

    // Перевіряємо: чи вже оброблений цей ключ?
    var existing = db.GetByIdempotencyKey(
        idempotencyKey);
    if (existing is not null)
    {
        // Повторний запит — повертаємо збережену відповідь
        return Results.Ok(existing);
    }

    // Перший раз — створюємо замовлення
    var order = db.CreateOrder(req, idempotencyKey);
    return Results.Created(
        $"/v1/orders/{order.Id}", order);
});

POST /v1/orders HTTP/1.1
X-Idempotency-Key: "req-abc-12345"
Content-Type: application/json

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

// Повторний запит з тим самим ключем:
POST /v1/orders HTTP/1.1
X-Idempotency-Key: "req-abc-12345"
→
HTTP/1.1 200 OK (повертає те саме замовлення)

app.MapPost("/v1/orders", 
    (OrderRequest req, HttpContext ctx) =>
{
    var order = db.CreateOrder(req);
    var newRevision = db.GetOrdersRevision(req.UserId);

    // Location — URL нового ресурсу
    // Клієнт може зробити GET для деталей
    ctx.Response.Headers.Location = 
        $"/v1/orders/{order.Id}";

    // Content-Location — URL, де можна отримати
    // актуальний стан колекції (із новою ревізією)
    ctx.Response.Headers["Content-Location"] = 
        $"/v1/orders?user_id={req.UserId}";

    // ETag — нова ревізія колекції
    ctx.Response.Headers.ETag = $"\"{newRevision}\"";

    return Results.Created(
        $"/v1/orders/{order.Id}", order);
});

async Task<HttpResponseMessage> SendWithRetry(
    HttpClient client,
    HttpRequestMessage request,
    int maxRetries = 3)
{
    for (int attempt = 0; attempt <= maxRetries; attempt++)
    {
        var response = await client.SendAsync(request);

        // Успіх або клієнтська помилка — не повторюємо
        if ((int)response.StatusCode < 500 
            && response.StatusCode != 
                System.Net.HttpStatusCode.TooManyRequests)
        {
            return response;
        }

        if (attempt == maxRetries)
            return response; // Вичерпано спроби

        // Retry-After від сервера або backoff
        var retryAfter = response.Headers.RetryAfter;
        var delay = retryAfter?.Delta 
            ?? TimeSpan.FromSeconds(
                Math.Pow(2, attempt)); // 1, 2, 4 сек

        await Task.Delay(delay);
    }

    throw new UnreachableException();
}