[Doh] terminology: "DNS API"

Tony Finch <dot@dotat.at> Wed, 06 June 2018 14:58 UTC

Return-Path: <dot@dotat.at>
X-Original-To: doh@ietfa.amsl.com
Delivered-To: doh@ietfa.amsl.com
Received: from localhost (localhost []) by ietfa.amsl.com (Postfix) with ESMTP id 7D2ED130F4C for <doh@ietfa.amsl.com>; Wed, 6 Jun 2018 07:58:24 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.2
X-Spam-Status: No, score=-4.2 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([]) by localhost (ietfa.amsl.com []) (amavisd-new, port 10024) with ESMTP id Zr_-JjLIY2MM for <doh@ietfa.amsl.com>; Wed, 6 Jun 2018 07:58:21 -0700 (PDT)
Received: from ppsw-32.csi.cam.ac.uk (ppsw-32.csi.cam.ac.uk []) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id C3679130F3A for <doh@ietf.org>; Wed, 6 Jun 2018 07:58:21 -0700 (PDT)
X-Cam-AntiVirus: no malware found
X-Cam-ScannerInfo: http://help.uis.cam.ac.uk/email-scanner-virus
Received: from grey.csi.cam.ac.uk ([]:39275) by ppsw-32.csi.cam.ac.uk (ppsw.cam.ac.uk []:25) with esmtps (TLSv1:ECDHE-RSA-AES256-SHA:256) id 1fQZtE-000UXX-1f (Exim 4.91) for doh@ietf.org (return-path <dot@dotat.at>); Wed, 06 Jun 2018 15:58:20 +0100
Date: Wed, 6 Jun 2018 15:58:20 +0100
From: Tony Finch <dot@dotat.at>
To: doh@ietf.org
Message-ID: <alpine.DEB.2.11.1806061550050.10764@grey.csi.cam.ac.uk>
User-Agent: Alpine 2.11 (DEB 23 2013-08-11)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Archived-At: <https://mailarchive.ietf.org/arch/msg/doh/7sOm5oMnLjBtVYJ-2o0IwPchOxM>
Subject: [Doh] terminology: "DNS API"
X-BeenThere: doh@ietf.org
X-Mailman-Version: 2.1.26
Precedence: list
List-Id: DNS Over HTTPS <doh.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/doh>, <mailto:doh-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/doh/>
List-Post: <mailto:doh@ietf.org>
List-Help: <mailto:doh-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/doh>, <mailto:doh-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 06 Jun 2018 14:58:25 -0000

Can we amend the document to replace "DNS API server" with "DNS-over-HTTPS
server" or "DoH server" please?

To me, "DNS API" suggests something like getaddrinfo() or getdns. I
understand that in the web world, "API" suggests something-over-HTTP
that isn't a web page, but even in this context I feel I should expect a
protocol involving more JSON.

f.anthony.n.finch  <dot@dotat.at>;  http://dotat.at/
Portland, Plymouth: Variable mainly northeast 3 or 4, increasing 5 at times.
Slight or moderate. Showers, becoming thundery. Moderate or good, occasionally
poor later.