~barry/mailman/lp1423756

« back to all changes in this revision

Viewing changes to src/mailman/rest/docs/systemconf.rst

  • Committer: Barry Warsaw
  • Date: 2015-01-05 01:20:33 UTC
  • mfrom: (7264.4.66 py3)
  • Revision ID: barry@list.org-20150105012033-zdrw9c2odhpf22fz
Merge the Python 3 branch.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
====================
2
 
System configuration
3
 
====================
4
 
 
5
 
The entire system configuration is available through the REST API.  You can
6
 
get a list of all defined sections.
7
 
 
8
 
    >>> dump_json('http://localhost:9001/3.0/system/configuration')
9
 
    http_etag: ...
10
 
    sections: ['antispam', 'archiver.mail_archive', 'archiver.master', ...
11
 
 
12
 
You can also get all the values for a particular section.
13
 
 
14
 
    >>> dump_json('http://localhost:9001/3.0/system/configuration/mailman')
15
 
    default_language: en
16
 
    email_commands_max_lines: 10
17
 
    filtered_messages_are_preservable: no
18
 
    http_etag: ...
19
 
    layout: testing
20
 
    noreply_address: noreply
21
 
    pending_request_life: 3d
22
 
    post_hook:
23
 
    pre_hook:
24
 
    sender_headers: from from_ reply-to sender
25
 
    site_owner: noreply@example.com
26
 
 
27
 
Dotted section names work too, for example, to get the French language
28
 
settings section.
29
 
 
30
 
    >>> dump_json('http://localhost:9001/3.0/system/configuration/language.fr')
31
 
    charset: iso-8859-1
32
 
    description: French
33
 
    enabled: yes
34
 
    http_etag: ...