From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: mail.toke.dk; spf=pass (mailfrom) smtp.mailfrom=irif.fr (client-ip=2001:660:3301:8000::1:2; helo=korolev.univ-paris7.fr; envelope-from=jch@irif.fr; receiver=) Authentication-Results: mail.toke.dk; dkim=pass (2048-bit key; unprotected) header.d=irif.fr header.i=@irif.fr header.a=rsa-sha256 header.s=dkim-irif header.b=kiY946eX Received: from korolev.univ-paris7.fr (korolev.univ-paris7.fr [IPv6:2001:660:3301:8000::1:2]) by mail.toke.dk (Postfix) with ESMTPS id 3AFACA63D6B for ; Thu, 11 Apr 2024 01:09:49 +0200 (CEST) Received: from potemkin.univ-paris7.fr (potemkin.univ-paris7.fr [IPv6:2001:660:3301:8000::1:1]) by korolev.univ-paris7.fr (8.14.4/8.14.4/relay1/82085) with ESMTP id 43AN9kVe004792 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Thu, 11 Apr 2024 01:09:46 +0200 Received: from mailhub.math.univ-paris-diderot.fr (mailhub.math.univ-paris-diderot.fr [81.194.30.253]) by potemkin.univ-paris7.fr (8.14.4/8.14.4/relay2/82085) with ESMTP id 43AN9ksH023581; Thu, 11 Apr 2024 01:09:46 +0200 Received: from mailhub.math.univ-paris-diderot.fr (localhost [127.0.0.1]) by mailhub.math.univ-paris-diderot.fr (Postfix) with ESMTP id E5079318A5; Thu, 11 Apr 2024 01:09:45 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=irif.fr; h= content-transfer-encoding:content-type:content-type:mime-version :user-agent:references:in-reply-to:subject:subject:from:from :message-id:date:date:received:received; s=dkim-irif; t= 1712790584; x=1713654585; bh=AqGfAVAhZk3VSOdL1IHBHP0biXQNp0RLlNp n61x2glM=; b=kiY946eXwqG24DuVMC0hPNbqv9Fwbufc44cYbZeJ0zYDMiNaJmX l0vpKGb/Jsaf1tLSSMWv8NtIE0recl+ccA9vKQHI03iDbov1zgiuZy76pd0Ccp9N a9961KdwhLI0xOUCOH3Q2oJ8vgIvPTW4rFDWmt2r8iA/jGd3cfrkGI+M6L1yV3Qp BzRui6HML1+x7BcxD6tBDdjMaAWbXP3YWz5lxisjmG5K7vQhTTV3sU+U7zCSozA+ ms16GXPXZ5m/WG5PZ3ArS9I0lWEP3gyBMQ5kybACv8ENQxc1R9R2K0ipWZVxgcAR hIRANWfzB0q1kx+AhhXn0XwgOG3PhXAUMPg== X-Virus-Scanned: amavisd-new at math.univ-paris-diderot.fr Received: from mailhub.math.univ-paris-diderot.fr ([127.0.0.1]) by mailhub.math.univ-paris-diderot.fr (mailhub.math.univ-paris-diderot.fr [127.0.0.1]) (amavisd-new, port 10023) with ESMTP id x_VVq5ZN20xm; Thu, 11 Apr 2024 01:09:44 +0200 (CEST) Received: from pirx.irif.fr (unknown [78.194.40.74]) (Authenticated sender: jch) by mailhub.math.univ-paris-diderot.fr (Postfix) with ESMTPSA id 354BC31665; Thu, 11 Apr 2024 01:09:43 +0200 (CEST) Date: Thu, 11 Apr 2024 01:09:43 +0200 Message-ID: <87y19ku85k.wl-jch@irif.fr> From: Juliusz Chroboczek To: "Gabriel Kerneis" 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> User-Agent: Wanderlust/2.15.9 (Almost Unreal) Emacs/29.2 Mule/6.0 MIME-Version: 1.0 (generated by SEMI-EPG 1.14.7 - "Harue") Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (korolev.univ-paris7.fr [IPv6:2001:660:3301:8000::1:2]); Thu, 11 Apr 2024 01:09:46 +0200 (CEST) X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (potemkin.univ-paris7.fr [194.254.61.141]); Thu, 11 Apr 2024 01:09:46 +0200 (CEST) X-Miltered: at korolev with ID 66171C3A.000 by Joe's j-chkmail (http : // j-chkmail dot ensmp dot fr)! X-Miltered: at potemkin with ID 66171C3A.000 by Joe's j-chkmail (http : // j-chkmail dot ensmp dot fr)! X-j-chkmail-Enveloppe: 66171C3A.000 from potemkin.univ-paris7.fr/potemkin.univ-paris7.fr/null/potemkin.univ-paris7.fr/ X-j-chkmail-Enveloppe: 66171C3A.000 from mailhub.math.univ-paris-diderot.fr/mailhub.math.univ-paris-diderot.fr/null/mailhub.math.univ-paris-diderot.fr/ X-j-chkmail-Score: MSGID : 66171C3A.000 on korolev.univ-paris7.fr : j-chkmail score : . : R=. U=. O=. B=0.000 -> S=0.000 X-j-chkmail-Score: MSGID : 66171C3A.000 on potemkin.univ-paris7.fr : j-chkmail score : . : R=. U=. O=. B=0.000 -> S=0.000 X-j-chkmail-Status: Ham X-j-chkmail-Status: Ham Message-ID-Hash: F5F6YY7HU4CNLE4D2DFAQILPIS32S74E X-Message-ID-Hash: F5F6YY7HU4CNLE4D2DFAQILPIS32S74E X-MailFrom: jch@irif.fr 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 CC: galene@lists.galene.org X-Mailman-Version: 3.3.9 Precedence: list Subject: [Galene] 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: Hi Gabriel! > I think you should keep [the ETag explanation] in the API documentation. Done. > I would format groupname and username (and other API parameters) in > italics to have them stand out, eg. in > `/galene-api/0/.groups/groupname/.users/username`. I'm not sure how to do that in a Markdown code block. > Explain the format of the stats endpoint. Clarified that the format is undocumented, and might change between versions. (If you're curious, see static/stats.js, but don't rely on it.) > Idem for group and user definition (is it json, is it compatible with > on-disk format, etc.). Maybe also specify the Content-Type for each > endpoint? Done and done, thanks. > Passwords: what do you mean exactly by "full password definition"? If > this refers to the on-disk format, again, I=A0think you should explicitly > cross-reference it. Done. Thanks again, -- Juliusz