xenial (1) mailman-api.1.gz

Provided by: mailman-api_0.2.9-1_all bug

NAME

       mailman-api - mailman-api Documentation

       Release v0.2.9

       mailman-api  provides a daemon that will listen to HTTP requests, providing access to a REST API that can
       be used to interact with a locally-installed Mailman (version 2) instance.

       mailman-api is tested with Python 2.7 and depends on:

       • paste >= 1.7

       • bottle >= 0.11.6

       mailman-api is a work in progress. Contributions are welcome. Feel free to fork and contribute!

QUICKSTART

   Installation
   Pip
       You can use pip to install mailman-api and requirements:

          $ pip install mailman-api

   Distro Packages
       We are currently working to provide linux packages (deb and rpm). Stay tunned!

   Running the Sevice
       To start the service manually just run the mailman-api command.

       If you installed mailman-api from a distribution package you should be able  to  start  your  service  by
       running service mailman-api start.

       Usage: mailman-api [options]

       Options:

              -h, --help
                     show this help message and exit

              -b BIND, --bind=BIND
                     Bind address. Default: '127.0.0.1:8000'.

              --allow-from=ALLOW_FROM
                     IPs to allow incoming requests. By deufalt only allow connections from '127.0.0.1'.

              -l MAILMANLIB_PATH, --mailman-lib-path=MAILMANLIB_PATH
                     Path to mailman libs directory. Default: '/usr/lib/mailman'.

              -d, --debug
                     Print debug information

API DOCUMENTATION

       Requests can be made to any of the URI's below, strictly using the HTTP methods indicated.

       The body of all responses contains valid JSON objects. Unless otherwise noted, successful requests get as
       response a 200 (OK) status code for response, and true in the response body.  Failed  requests  will  get
       responses  with  some  HTTP  error  code in the 400s, and a string describing the problem in the response
       body.

       Supported methods:

LICENSING INFORMATION

       Copyright (C) 2013-2014 Sergio Oliveira Campos

       This program is free software; you can redistribute it and/or modify  it  under  the  terms  of  the  GNU
       General  Public License as published by the Free Software Foundation; either version 2 of the License, or
       (at your option) any later version.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY  WARRANTY;  without  even
       the  implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
       License for more details.

       You should have received a copy of the GNU General Public License along with this program; if not,  write
       to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

AUTHOR

       Sergio Oliveira

       2014, Sergio Oliveira Campos