[httpapi] Re: Renaming HTTP Header Idempotence-Key -> Deduplication-Key
Stanislav Bashkyrtsev <stanislav.bashkirtsev@gmail.com> Tue, 09 December 2025 13:50 UTC
Return-Path: <stanislav.bashkirtsev@gmail.com>
X-Original-To: httpapi@mail2.ietf.org
Delivered-To: httpapi@mail2.ietf.org
Received: from localhost (localhost [127.0.0.1]) by mail2.ietf.org (Postfix) with ESMTP id AD79D97FBCA0 for <httpapi@mail2.ietf.org>; Tue, 9 Dec 2025 05:50:45 -0800 (PST)
X-Virus-Scanned: amavisd-new at ietf.org
X-Spam-Flag: NO
X-Spam-Score: -2.098
X-Spam-Level:
X-Spam-Status: No, score=-2.098 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=unavailable autolearn_force=no
Authentication-Results: mail2.ietf.org (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
Received: from mail2.ietf.org ([166.84.6.31]) by localhost (mail2.ietf.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id xm8FPxb-7-0P for <httpapi@mail2.ietf.org>; Tue, 9 Dec 2025 05:50:45 -0800 (PST)
Received: from mail-pf1-x435.google.com (mail-pf1-x435.google.com [IPv6:2607:f8b0:4864:20::435]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (P-256) server-digest SHA256) (No client certificate requested) by mail2.ietf.org (Postfix) with ESMTPS id 7491797FBC94 for <httpapi@ietf.org>; Tue, 9 Dec 2025 05:50:45 -0800 (PST)
Received: by mail-pf1-x435.google.com with SMTP id d2e1a72fcca58-7b8bbf16b71so6207992b3a.2 for <httpapi@ietf.org>; Tue, 09 Dec 2025 05:50:45 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1765288244; x=1765893044; darn=ietf.org; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :from:to:cc:subject:date:message-id:reply-to; bh=PjqtkcwzSW71M44F4iguOLnh8+zebCy9QwaqRfcR3pI=; b=kVhwGrcFd+QoqsfUXVPo1yIvDWeVjidXMD5gsNvYSpJFGGrlzCzcgxBeMApTjN9EYT 36TuWPM+XcCu4/7GEbUplEQRk9GpjIDp/o4UL7+xXObaYPEjrzyuxZSXJqV2ZOBROmRE pz7ahZozsVkWe5ZzzL3KKLyOP7ty9NpC4qsk59jetC7u4nupyRf4LCSlJ2EJnNPG+tDW DRHx43QUrdbH03Z2581PfpQZY1JxhyUQVLwCw466Ezq+TA2fw/PH8ySCoZK3o1liGfCS Mr7fh0Y/UV4ZoW5WKFk5cUrGeaGpsT5+z1BnWwoSIBvgj/pNtUrxMhkDa+M2ysNQK3Id JJGw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1765288244; x=1765893044; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :x-gm-gg:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=PjqtkcwzSW71M44F4iguOLnh8+zebCy9QwaqRfcR3pI=; b=sRbf2rWXMIGl1dtaEmEZRpZ3Kb80+fq8pHYY9425izb8HKUwYiQZ6k55XxcD4c3tDD Qj/kZqa6n+cfe1mJQBFXfRr4GbQ3IPZCh0jLLsL9tLzEQ5nUlzr1XF3yrC4ezsUCJI5Y qguAqX8ReoULB2z2cZjQ+YLhSAy8yMAn/ZJ6pjDkm+M37bW2Hgqr4ctT6sxnt5HTPNJP xc7UA1Ekx1ZDI5Ld7DT0Y3pEQQ0KSY7hHreYpYMZD8JAjMy1otSDHxLkArMUG/eJ1QJp cu+LYc77L8u1wNvIm70gRBDHul70OvvebNZs5zoa8MX85VdqzlR4+e0CT6kNzEGZ7GRC Jb7g==
X-Gm-Message-State: AOJu0Yx2/nh+IupFwYCmP46Spr+RamIoMCcpPCDaX4g34uGkk1UNhaf0 e4CQ4YgGVWTwsgLNDjBYx/u032z96kO2PCDO8uUaIktBppYM75RgRjpedXF8zZaH1z3XBnwH8xU ssq3QR7NbLYtgYXzDeV9bFOW4RJow0TAezXhT
X-Gm-Gg: ASbGncv74zpx/y9ikETROyIGcPAol33S4Q0o2i6CztYZFBNjqAB4Bb8/UsWw3nHyaSx qWnOEuzhwLcppABhZNJAaBHjl+ZSRX9iDVM1sJhdbmkwLlrwrgYVXvYl0LaSNjXKiyjwnNvX5t/ yFmNS2ajOqpo1AFyicT4P/hQdWFDnkLwCriinSOk56hkZppKcsl/5n2WxchydbtkV5Yyj1MBBRH Y6jSF0jogMls3r8GcbU2rqxG0gkzMNlo3hS/MC/cn2ub90Nr0c89H36ENQ4V2dy5y8SNw==
X-Google-Smtp-Source: AGHT+IFMlrEgGBvCt/E6vSU9z4uWwBIAA8A8DW21v6W5uSA+AJhljHLUe/HydLgFNkXmCwrZu48DfQI0Bxi+mL4uUCU=
X-Received: by 2002:a05:7022:f415:b0:11b:9386:a3cd with SMTP id a92af1059eb24-11e032ed8fcmr8929427c88.46.1765288244156; Tue, 09 Dec 2025 05:50:44 -0800 (PST)
MIME-Version: 1.0
References: <CAMtnYL-+mWRH=NheDCv3PvbfQjh7Vr2AmF8yQVuh7_C+9tUL5w@mail.gmail.com>
In-Reply-To: <CAMtnYL-+mWRH=NheDCv3PvbfQjh7Vr2AmF8yQVuh7_C+9tUL5w@mail.gmail.com>
From: Stanislav Bashkyrtsev <stanislav.bashkirtsev@gmail.com>
Date: Tue, 09 Dec 2025 15:50:32 +0200
X-Gm-Features: AQt7F2qbDyq0hEN9dmmlaIoLNjGUABa-7NXP3qlgqrcuRrvQek5nXJiGD9r_knw
Message-ID: <CAMtnYL_GN=bvz6qsqBt5BA3TxaKY+Md7y-Mseb8N4nYvFCPG9Q@mail.gmail.com>
To: httpapi@ietf.org, draft-ietf-httpapi-idempotency-key-header@ietf.org, "jayadebaj@gmail.com" <jayadebaj@gmail.com>, "sanjay.dalal@berkeley.edu" <sanjay.dalal@berkeley.edu>
Content-Type: multipart/alternative; boundary="000000000000b81a780645853238"
X-MailFrom: stanislav.bashkirtsev@gmail.com
X-Mailman-Rule-Hits: nonmember-moderation
X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation
Message-ID-Hash: 26VSOZEONRJBKWBQK2FQEDYMSBBBLWQM
X-Message-ID-Hash: 26VSOZEONRJBKWBQK2FQEDYMSBBBLWQM
X-Mailman-Approved-At: Tue, 09 Dec 2025 05:53:05 -0800
X-Mailman-Version: 3.3.9rc6
Precedence: list
Subject: [httpapi] Re: Renaming HTTP Header Idempotence-Key -> Deduplication-Key
List-Id: Building Blocks for HTTP APIs <httpapi.ietf.org>
Archived-At: <https://mailarchive.ietf.org/arch/msg/httpapi/YMmSoxIQ2LMKBZrFGzB1RqyFK_I>
List-Archive: <https://mailarchive.ietf.org/arch/browse/httpapi>
List-Help: <mailto:httpapi-request@ietf.org?subject=help>
List-Owner: <mailto:httpapi-owner@ietf.org>
List-Post: <mailto:httpapi@ietf.org>
List-Subscribe: <mailto:httpapi-join@ietf.org>
List-Unsubscribe: <mailto:httpapi-leave@ietf.org>
Don't know if the DLs work, so including authors explicitly. On Wed, Nov 26, 2025 at 12:42 AM Stanislav Bashkyrtsev < stanislav.bashkirtsev@gmail.com> wrote: > Hi everyone, > > I noticed the draft about the new header, and it seems like the currently > suggested name isn't really suitable. Deduplication doesn't lead to > Idempotency. This is a common confusion, popularized by Kafka. > > Deduplication is needed when the operation is NOT idempotent. Here's a > practical difference: > > 1. Client sends Request1 -> the result is State1 > 2. Client sends Request2 -> the result is State2 > 3. Client re-sends Request1 > > Idempotent operation results in State1, while the API w/ Deduplication > results in State2. > > Thinking about it in terms of math operations may be better. E.g. > multiplying by 0 is idempotent because you CAN actually repeat it multiple > times - and the result will be the same. > > Would be great to rename the header while it's still a draft. >
- [httpapi] Re: Renaming HTTP Header Idempotence-Ke… Stanislav Bashkyrtsev