From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: mail.toke.dk; spf=pass (mailfrom) smtp.mailfrom=skoll.ca (client-ip=144.217.161.9; helo=dianne.skoll.ca; envelope-from=dianne@skoll.ca; receiver=) Authentication-Results: mail.toke.dk; dkim=pass (2048-bit key; secure) header.d=skoll.ca header.i=@skoll.ca header.a=rsa-sha256 header.s=canit2 header.b=j1YpuIYh Received: from dianne.skoll.ca (dianne.skoll.ca [144.217.161.9]) by mail.toke.dk (Postfix) with ESMTPS id BCF06A63DCA for ; Thu, 11 Apr 2024 02:02:04 +0200 (CEST) Received: from pi4.skoll.ca ([192.168.84.18]) by dianne.skoll.ca (8.17.1.9/8.17.1.9/Debian-2) with ESMTPS id 43B023ag015020 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384 bits=256 verify=NOT) for ; Wed, 10 Apr 2024 20:02:03 -0400 Received: from gato.skoll.ca (gato.skoll.ca [192.168.83.21]) by pi4.skoll.ca (Postfix) with ESMTPS id 4VFKcp5nXnzgd52Y for ; Wed, 10 Apr 2024 20:02:02 -0400 (EDT) Date: Wed, 10 Apr 2024 20:02:02 -0400 From: Dianne Skoll To: galene@lists.galene.org Message-ID: <20240410200202.74875148@gato.skoll.ca> In-Reply-To: <32abf60e-fc7c-45cc-81d4-2c08feb16a04@app.fastmail.com> References: <877ch5uhul.wl-jch@irif.fr> <32abf60e-fc7c-45cc-81d4-2c08feb16a04@app.fastmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=skoll.ca; h=date :from:to:subject:message-id:in-reply-to:references:mime-version :content-type:content-transfer-encoding; s=canit2; bh=zDFQX3ELNo xa7PPHfe0edj3xfUIUMlPL3Xy7pWYEBp0=; b=j1YpuIYhLvbgYe3SeuoGna3LI4 XerUClSbyhSoFJK3VlRDIe99MyMcTJru4M8hyvQBlxbf1zi9z81Kayi1fqYe2dPt zQcJl8WVjQSPoSupdO8RtYb+eoV86aMHpHJAQreviFGufSDkrimHzokihe0sBczh 00yhYonfEHr4ry4urxXGay6/uibIAFukasuBecXCBSwDsHl0CVnn8ZdyGAi6gdaB mVRdlrtQeHkCvUujU2SSgRSoYl5Gao7UE4ERvxI7pObcerlQ11ZU9DlXScmLCwr3 ORv/hw7QcX3JHKP/OHDsStTl+wZ6E5hBOajUWMn4gb1PlF2vnrFKTonJDLeA== X-Scanned-By: CanIt (www . roaringpenguin . com) X-Scanned-By: mailmunge 3.16 on 192.168.83.18 X-Spam-Score: undef - relay 192.168.84.18 marked with skip_spam_scan X-CanIt-Geo: No geolocation information available for 192.168.84.18 X-CanItPRO-Stream: outbound (inherits from default) X-Canit-Stats-ID: Bayes signature not available X-CanIt-Archive-Cluster: tWKWaF/NcZkqjWIj0BEJTBHJhwY X-CanIt-Archived-As: base/20240410 / 01c9A2309 Message-ID-Hash: Y3GVSXN7KZZPVNFIFXZ2NJ6Q42YLQCBH X-Message-ID-Hash: Y3GVSXN7KZZPVNFIFXZ2NJ6Q42YLQCBH X-MailFrom: dianne@skoll.ca X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.9 Precedence: list Subject: [Galene] API versioning (was Re: Re: API documentation) List-Id: =?utf-8?q?Gal=C3=A8ne_videoconferencing_server_discussion_list?= Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: On Wed, 10 Apr 2024 22:47:36 +0200 "Gabriel Kerneis" wrote: > The /0/ is intriguing, but maybe just because I'm not used to REST > API design. I'd add a sentence explaining its versioning purpose > anyway. It was I who suggested a versioned API. My thinking was that if there's some drastic change to the API, the version number could be incremented, but (where feasible) the old API could still be supported so older API clients would still work. It may turn out to be completely unnecessary. But still, the cost of doing it and not needing it is small, whereas the cost of not doing it and then discovering it is needed is large. Regards, Dianne.