Revision as of 06:16, 18 June 2013

Account Management API

The account management API provides methods for managing the account contacts, users and products. Clients can update the status of the account products as well as change (upgrade/downgrade) them.

download this selection of articles as a PDF book

Account Management

• GET /accounts/{accountId} - Returns information about an account
• GET /partnerAccounts/{partnerAccountId} - Returns information about an account specified by its partner Id
• PUT /accounts/{accountId} - Updates account status
• PUT /partnerAccounts/{partnerAccountId} - Updates account status for account specified by its partner Id
• DELETE /accounts/{accountId} - Purges an account from the system
• DELETE /partnerAccounts/{partnerAccountId} - Purges an account specified by its partner Id from the system

Contacts Management

• GET /accounts/{accountId}/contacts - Returns all contacts for an account

Users Management

• PUT /accounts/{accountId}/user - Updates the account user password

Products Management

• GET /accounts/{accountId}/products - Gets all products for an account
• GET /accounts/{accountId}/products/{productId} - Get information about a product
• PUT /accounts/{accountId}/products/{productId} - Update the status of a product
• POST /accounts/{accountId}/products/{productId}/action - Perform an action (e.g: upgrade/downgrade) for a product

Products Bandwidth Management

• GET /accounts/{accountId}/products/{productId}/bandwidth/daily?filterType={filterType}&from={filterStartDate}&to={filterEndDate} - Get a report on the daily bandwidth usage of the product
• GET /accounts/{accountId}/products/{productId}/bandwidth/weekly?filterType={filterType}&from={filterStartDate}&to=filterEndDate} - Get a report on the weekly bandwidth usage of the product
• GET /accounts/{accountId}/products/{productId}/bandwidth/monthly?filterType={filterType}&from={filterStartDate}&to=filterEndDate} - Get a report on the monthly bandwidth usage of the product
• GET /accounts/{accountId}/products/{productId}/bandwidth/yearly?filterType={filterType}&from={filterStartDate}&to=filterEndDate} - Get a report on the yearly bandwidth usage of the product

Each bandwidth usage is filtered by the traffic type(www or ftp), the start date and the end date in ISO format(eg. 2013-20-02).

Products Usage Management

• GET /accounts/{accountId}/products/{productId}/usage - Get an aggregated services usage report of a product

See also

• Common Features