This is the FAX.PLUS API v1 developed for third party developers and organizations. In order to have a better coding experience with this API, let's quickly go through some points:

- This API assumes /accounts as an entry point with the base url of https://restapi.fax.plus/v1.

- This API treats all date and times sent to it in requests as UTC. Also, all dates and times returned in responses are in UTC

- Once you have an access_token, you can easily send a request to the resource server with the base url of https://restapi.fax.plus/v1 to access your permitted resources. As an example to get the user's profile info you would send a request to https://restapi.fax.plus/v1/accounts/self when Authorization header is set to "Bearer YOUR_ACCESS_TOKEN" and custom header of x-fax-clientid is set to YOUR_CLIENT_ID

Python 2.7 and 3.4+

You can simply install SDK from pypi repository

pip install faxplus-api

You can also install directly from Github

pip install git+https://github.com/alohi/faxplus-python.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/alohi/faxplus-python.git)

Then import the package:

import faxplus 

Install via Setuptools.

python setup.py install --user

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

Then import the package:

import faxplus

If you haven't already, please follow the installation procedure to install the sdk

There's a sample app located at sample-app folder to get you started. It contains sample code to get access_token and use refresh token to renew access_token. It also contains sample requests to all endpoints and a GUI to view responses easily.

• sample app runs on localhost:8080. so you need to add http://localhost:8080/cb/ to your redirect uris in our website.
• run following commands to install requirements and create a config.json file

cd sample-app
pip install -r requirements.txt
cp sample.config.json config.json

• edit config.json add your client_id and secret
• run python app.py to run sample app.

All URIs are relative to https://restapi.fax.plus/v1

• Account
• AccountAccountData
• AccountSettings
• AccountSettingsSendFax
• AccountSettingsSendFaxRetry
• Error
• Fax
• FaxCostDetails
• File
• MemberDetail
• Number
• NumberNotifications
• Outbox
• OutboxComment
• OutboxFileChanges
• OutboxFiles
• OutboxInitiatedFrom
• OutboxStatusChanges
• PayloadFaxModification
• PayloadNumberModification
• PayloadOutbox
• PayloadOutboxComment
• PayloadOutboxModification
• PayloadOutboxOptions
• PayloadOutboxOptionsRetry
• ResponseAccountList
• ResponseArchive
• ResponseArchiveData
• ResponseNumberList
• ResponseOutboxList

• Type: OAuth
• Flow: accessCode
• Authorization URL: https://accounts.fax.plus/login?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=http://localhost&scope=all
• Scopes:
• all: for now when a user grant permission, all grants will be permitted

• PayloadOutbox and Fax models contain a field named "from" but from is a reserved keyword in python. Use "from_number" instead of "from" for those models.