Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/badsyntax/mailinabox-api-py

Python client SDK for the Mail-in-a-Box API.
https://github.com/badsyntax/mailinabox-api-py
mail-in-a-box mailinabox openapi
Last synced: 19 days ago
JSON representation
Python client SDK for the Mail-in-a-Box API.
Host: GitHub
URL: https://github.com/badsyntax/mailinabox-api-py
Owner: badsyntax
Created: 2020-08-04T16:55:58.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2021-05-11T06:10:57.000Z (over 3 years ago)
Last Synced: 2024-10-11T20:11:41.391Z (about 1 month ago)
Topics: mail-in-a-box, mailinabox, openapi
Language: Python
Homepage: https://pypi.org/project/mailinabox-api
Size: 325 KB
Stars: 4
Watchers: 3
Forks: 0
Open Issues: 3
Metadata Files:
- Readme: README.md
Awesome Lists containing this project

README

        # mailinabox-api

[![Build & Publish](https://github.com/badsyntax/mailinabox-api/workflows/Build%20&%20Publish/badge.svg)](https://github.com/badsyntax/mailinabox-api/actions?query=workflow%3A%22Build+%26+Publish%22)

Python client SDK for the Mail-in-a-Box API.

- API version: 0.51.0

- Package version: 0.51.1

https://pypi.org/project/mailinabox-api

**NOTE:** This package is [auto-generated](https://github.com/badsyntax/mailinabox-api) from the Mail-In-A-Box OpenAPI spec.

## Requirements

Python 2.7 and 3.4+

## Installation & Usage

### pip install

If the python package is hosted on a repository, you can install directly using:

```sh

pip install git+https://github.com/badsyntax/mailinabox-api-py.git

```

(you may need to run `pip` with root permission: `sudo pip install git+https://github.com/badsyntax/mailinabox-api-py.git`)

Then import the package:

```python

import mailinabox_api

```

### Setuptools

Install via [Setuptools](http://pypi.python.org/pypi/setuptools).

```sh

python setup.py install --user

```

(or `sudo python setup.py install` to install the package for all users)

Then import the package:

```python

import mailinabox_api

```

## Getting Started

Please follow the [installation procedure](#installation--usage) and then run the following:

```python

from __future__ import print_function

import time

import mailinabox_api

from mailinabox_api.rest import ApiException

from pprint import pprint

# Defining the host is optional and defaults to https://box.example.com/admin

# See configuration.py for a list of all supported configuration parameters.

configuration = mailinabox_api.Configuration(

    host = "https://box.example.com/admin"

)

# The client must configure the authentication and authorization parameters

# in accordance with the API server security policy.

# Examples for each auth method are provided below, use the example that

# satisfies your auth use case.

# Configure HTTP basic authorization: basicAuth

configuration = mailinabox_api.Configuration(

    username = 'YOUR_USERNAME',

    password = 'YOUR_PASSWORD'

)

# Enter a context with an instance of the API client

with mailinabox_api.ApiClient(configuration) as api_client:

    # Create an instance of the API class

    api_instance = mailinabox_api.DNSApi(api_client)

    qname = 'qname_example' # str | DNS query name.

    body = 1.2.3.4 # str | 

    try:

        # Add DNS custom A record

        api_response = api_instance.add_dns_custom_a_record(qname, body)

        pprint(api_response)

    except ApiException as e:

        print("Exception when calling DNSApi->add_dns_custom_a_record: %s\n" % e)

    

```

## Documentation for API Endpoints

All URIs are relative to *https://box.example.com/admin*

Class | Method | HTTP request | Description

------------ | ------------- | ------------- | -------------

*DNSApi* | [**add_dns_custom_a_record**](docs/DNSApi.md#add_dns_custom_a_record) | **POST** /dns/custom/{qname} | Add DNS custom A record

*DNSApi* | [**add_dns_custom_record**](docs/DNSApi.md#add_dns_custom_record) | **POST** /dns/custom/{qname}/{rtype} | Add DNS custom record

*DNSApi* | [**add_dns_secondary_nameserver**](docs/DNSApi.md#add_dns_secondary_nameserver) | **POST** /dns/secondary-nameserver | Add DNS secondary nameserver

*DNSApi* | [**get_dns_custom_a_records_for_q_name**](docs/DNSApi.md#get_dns_custom_a_records_for_q_name) | **GET** /dns/custom/{qname} | Get DNS custom A records

*DNSApi* | [**get_dns_custom_records**](docs/DNSApi.md#get_dns_custom_records) | **GET** /dns/custom | Get DNS custom records

*DNSApi* | [**get_dns_custom_records_for_q_name_and_type**](docs/DNSApi.md#get_dns_custom_records_for_q_name_and_type) | **GET** /dns/custom/{qname}/{rtype} | Get DNS custom records

*DNSApi* | [**get_dns_dump**](docs/DNSApi.md#get_dns_dump) | **GET** /dns/dump | Get DNS dump

*DNSApi* | [**get_dns_secondary_nameserver**](docs/DNSApi.md#get_dns_secondary_nameserver) | **GET** /dns/secondary-nameserver | Get DNS secondary nameserver

*DNSApi* | [**get_dns_zonefile**](docs/DNSApi.md#get_dns_zonefile) | **GET** /dns/zonefile/{zone} | Get DNS zonefile

*DNSApi* | [**get_dns_zones**](docs/DNSApi.md#get_dns_zones) | **GET** /dns/zones | Get DNS zones

*DNSApi* | [**remove_dns_custom_a_record**](docs/DNSApi.md#remove_dns_custom_a_record) | **DELETE** /dns/custom/{qname} | Remove DNS custom A record

*DNSApi* | [**remove_dns_custom_record**](docs/DNSApi.md#remove_dns_custom_record) | **DELETE** /dns/custom/{qname}/{rtype} | Remove DNS custom record

*DNSApi* | [**update_dns**](docs/DNSApi.md#update_dns) | **POST** /dns/update | Update DNS

*DNSApi* | [**update_dns_custom_a_record**](docs/DNSApi.md#update_dns_custom_a_record) | **PUT** /dns/custom/{qname} | Update DNS custom A record

*DNSApi* | [**update_dns_custom_record**](docs/DNSApi.md#update_dns_custom_record) | **PUT** /dns/custom/{qname}/{rtype} | Update DNS custom record

*MFAApi* | [**mfa_status**](docs/MFAApi.md#mfa_status) | **POST** /mfa/status | Retrieve MFA status for you or another user

*MFAApi* | [**mfa_totp_disable**](docs/MFAApi.md#mfa_totp_disable) | **POST** /mfa/disable | Disable multi-factor authentication for you or another user

*MFAApi* | [**mfa_totp_enable**](docs/MFAApi.md#mfa_totp_enable) | **POST** /mfa/totp/enable | Enable TOTP authentication

*MailApi* | [**add_mail_user**](docs/MailApi.md#add_mail_user) | **POST** /mail/users/add | Add mail user

*MailApi* | [**add_mail_user_privilege**](docs/MailApi.md#add_mail_user_privilege) | **POST** /mail/users/privileges/add | Add mail user privilege

*MailApi* | [**get_mail_aliases**](docs/MailApi.md#get_mail_aliases) | **GET** /mail/aliases | Get mail aliases

*MailApi* | [**get_mail_domains**](docs/MailApi.md#get_mail_domains) | **GET** /mail/domains | Get mail domains

*MailApi* | [**get_mail_user_privileges**](docs/MailApi.md#get_mail_user_privileges) | **GET** /mail/users/privileges | Get mail user privileges

*MailApi* | [**get_mail_users**](docs/MailApi.md#get_mail_users) | **GET** /mail/users | Get mail users

*MailApi* | [**remove_mail_alias**](docs/MailApi.md#remove_mail_alias) | **POST** /mail/aliases/remove | Remove mail alias

*MailApi* | [**remove_mail_user**](docs/MailApi.md#remove_mail_user) | **POST** /mail/users/remove | Remove mail user

*MailApi* | [**remove_mail_user_privilege**](docs/MailApi.md#remove_mail_user_privilege) | **POST** /mail/users/privileges/remove | Remove mail user privilege

*MailApi* | [**set_mail_user_password**](docs/MailApi.md#set_mail_user_password) | **POST** /mail/users/password | Set mail user password

*MailApi* | [**upsert_mail_alias**](docs/MailApi.md#upsert_mail_alias) | **POST** /mail/aliases/add | Upsert mail alias

*SSLApi* | [**generate_sslcsr**](docs/SSLApi.md#generate_sslcsr) | **POST** /ssl/csr/{domain} | Generate SSL CSR

*SSLApi* | [**get_ssl_status**](docs/SSLApi.md#get_ssl_status) | **GET** /ssl/status | Get SSL status

*SSLApi* | [**install_ssl_certificate**](docs/SSLApi.md#install_ssl_certificate) | **POST** /ssl/install | Install SSL certificate

*SSLApi* | [**provision_ssl_certificates**](docs/SSLApi.md#provision_ssl_certificates) | **POST** /ssl/provision | Provision SSL certificates

*SystemApi* | [**get_system_backup_config**](docs/SystemApi.md#get_system_backup_config) | **GET** /system/backup/config | Get system backup config

*SystemApi* | [**get_system_backup_status**](docs/SystemApi.md#get_system_backup_status) | **GET** /system/backup/status | Get system backup status

*SystemApi* | [**get_system_privacy_status**](docs/SystemApi.md#get_system_privacy_status) | **GET** /system/privacy | Get system privacy status

*SystemApi* | [**get_system_reboot_status**](docs/SystemApi.md#get_system_reboot_status) | **GET** /system/reboot | Get system reboot status

*SystemApi* | [**get_system_status**](docs/SystemApi.md#get_system_status) | **POST** /system/status | Get system status

*SystemApi* | [**get_system_updates**](docs/SystemApi.md#get_system_updates) | **GET** /system/updates | Get system updates

*SystemApi* | [**get_system_upstream_version**](docs/SystemApi.md#get_system_upstream_version) | **POST** /system/latest-upstream-version | Get system upstream version

*SystemApi* | [**get_system_version**](docs/SystemApi.md#get_system_version) | **GET** /system/version | Get system version

*SystemApi* | [**reboot_system**](docs/SystemApi.md#reboot_system) | **POST** /system/reboot | Reboot system

*SystemApi* | [**update_system_backup_config**](docs/SystemApi.md#update_system_backup_config) | **POST** /system/backup/config | Update system backup config

*SystemApi* | [**update_system_packages**](docs/SystemApi.md#update_system_packages) | **POST** /system/update-packages | Update system packages

*SystemApi* | [**update_system_privacy**](docs/SystemApi.md#update_system_privacy) | **POST** /system/privacy | Update system privacy

*UserApi* | [**get_me**](docs/UserApi.md#get_me) | **GET** /me | Get user information

*WebApi* | [**get_web_domains**](docs/WebApi.md#get_web_domains) | **GET** /web/domains | Get web domains

*WebApi* | [**update_web**](docs/WebApi.md#update_web) | **POST** /web/update | Update web

## Documentation For Models

 - [DNSCustomRecord](docs/DNSCustomRecord.md)

 - [DNSCustomRecordsResponse](docs/DNSCustomRecordsResponse.md)

 - [DNSDumpDomainRecord](docs/DNSDumpDomainRecord.md)

 - [DNSDumpDomainRecords](docs/DNSDumpDomainRecords.md)

 - [DNSDumpDomains](docs/DNSDumpDomains.md)

 - [DNSDumpResponse](docs/DNSDumpResponse.md)

 - [DNSRecordType](docs/DNSRecordType.md)

 - [DNSSecondaryNameserverAddRequest](docs/DNSSecondaryNameserverAddRequest.md)

 - [DNSSecondaryNameserverResponse](docs/DNSSecondaryNameserverResponse.md)

 - [DNSUpdateRequest](docs/DNSUpdateRequest.md)

 - [DNSZonesResponse](docs/DNSZonesResponse.md)

 - [MailAlias](docs/MailAlias.md)

 - [MailAliasByDomain](docs/MailAliasByDomain.md)

 - [MailAliasRemoveRequest](docs/MailAliasRemoveRequest.md)

 - [MailAliasUpsertRequest](docs/MailAliasUpsertRequest.md)

 - [MailAliasesResponseFormat](docs/MailAliasesResponseFormat.md)

 - [MailUser](docs/MailUser.md)

 - [MailUserAddPrivilegeRequest](docs/MailUserAddPrivilegeRequest.md)

 - [MailUserAddRequest](docs/MailUserAddRequest.md)

 - [MailUserByDomain](docs/MailUserByDomain.md)

 - [MailUserPrivilege](docs/MailUserPrivilege.md)

 - [MailUserRemovePrivilegeRequest](docs/MailUserRemovePrivilegeRequest.md)

 - [MailUserRemoveRequest](docs/MailUserRemoveRequest.md)

 - [MailUserSetPasswordRequest](docs/MailUserSetPasswordRequest.md)

 - [MailUserStatus](docs/MailUserStatus.md)

 - [MailUsersResponse](docs/MailUsersResponse.md)

 - [MailUsersResponseFormat](docs/MailUsersResponseFormat.md)

 - [MeAuthStatus](docs/MeAuthStatus.md)

 - [MeResponse](docs/MeResponse.md)

 - [MfaDisableRequest](docs/MfaDisableRequest.md)

 - [MfaEnableRequest](docs/MfaEnableRequest.md)

 - [MfaStatusResponse](docs/MfaStatusResponse.md)

 - [MfaStatusResponseEnabledMfa](docs/MfaStatusResponseEnabledMfa.md)

 - [MfaStatusResponseNewMfa](docs/MfaStatusResponseNewMfa.md)

 - [SSLCSRGenerateRequest](docs/SSLCSRGenerateRequest.md)

 - [SSLCertificateInstallRequest](docs/SSLCertificateInstallRequest.md)

 - [SSLCertificatesProvisionResponse](docs/SSLCertificatesProvisionResponse.md)

 - [SSLCertificatesProvisionResponseRequests](docs/SSLCertificatesProvisionResponseRequests.md)

 - [SSLStatus](docs/SSLStatus.md)

 - [SSLStatusResponse](docs/SSLStatusResponse.md)

 - [SSLStatusType](docs/SSLStatusType.md)

 - [StatusEntry](docs/StatusEntry.md)

 - [StatusEntryExtra](docs/StatusEntryExtra.md)

 - [StatusEntryType](docs/StatusEntryType.md)

 - [SystemBackupConfigResponse](docs/SystemBackupConfigResponse.md)

 - [SystemBackupConfigUpdateRequest](docs/SystemBackupConfigUpdateRequest.md)

 - [SystemBackupStatus](docs/SystemBackupStatus.md)

 - [SystemBackupStatusResponse](docs/SystemBackupStatusResponse.md)

 - [SystemPrivacyStatus](docs/SystemPrivacyStatus.md)

 - [SystemPrivacyUpdateRequest](docs/SystemPrivacyUpdateRequest.md)

 - [SystemStatusResponse](docs/SystemStatusResponse.md)

 - [WebDomain](docs/WebDomain.md)

## Documentation For Authorization

## basicAuth

- **Type**: HTTP basic authentication