On Apr 27, 2013, at 2:42 AM, "Stephen J. Turnbull" <turnb...@sk.tsukuba.ac.jp> wrote:
> Richard Wackerbarth writes: > >> https://server.example.com/mailman/list/ABCDEFG/attribute/join_address >> returns the email address to which subscription requests should be >> sent. > > "ABCDEFG" is what? The list? Yes. But note that it is some pk provided by the list store. It may not have any recognizable relationship to other characteristics of the list ( such as a "common name" or FQDN ) > > I think the short prefix /mailman/ should be reserved for traditional > and anonymous requests. /mailman/rest_api/ or some such for the > REST API. I don't disagree. I would reserve /.well_known/mailman/ as an access point that delivers the "root" of the REST API tree and, otherwise, make no assumption about the location of it in URI space. > >> https://server.example.com/mailman/list/ABCDEFG/attributes > > This is what you mean by self-documenting? No. This is an access point for the document. If fetched as JSON or XML, it would be machine parseable. If fetched as HTML/text, it would be human readable. > Presumably it returns not only the attribute names, but their ranges (types) > and docstrings? > >> https://server.example.com/mailman/attribute/posting_address/test_l...@example.com >> would return the URI representing the list > > Why have you changed the order of components here? Because I don't know the pk for the list. I wish to look it up. > >> https://server.example.com/mailman/attribute/posting_address/test_l...@example.com/attribute/join_address >> might return test_list-j...@example.com > > Huh? This isn't a syntax error? Probably is syntactically incorrect. The email address would need to be URL escaped. _______________________________________________ Mailman-Developers mailing list Mailman-Developers@python.org http://mail.python.org/mailman/listinfo/mailman-developers Mailman FAQ: http://wiki.list.org/x/AgA3 Searchable Archives: http://www.mail-archive.com/mailman-developers%40python.org/ Unsubscribe: http://mail.python.org/mailman/options/mailman-developers/archive%40jab.org Security Policy: http://wiki.list.org/x/QIA9
