tropo

README

tropo

====

Synopsis

Small go library used by Tropo team to lookup data from Tropo Provisioning API.

Types of lookups:

• address
  • pin
  • token
  • number
• users
  • username
  • userId
• Applications
  • applicationId
• guid

Usage

Create config file

; Default api-config
; https://github.com/robfig/config
[DEFAULT]
host: api.aws.tropo.com
route: /rest/v1
protocol: https://
base-url: %(protocol)s%(host)s%(route)s

[hosted]
url: %(base-url)s
username: username
password: abc123

Install Application

go install

Rule the world

NAME:
   tropo - Tropo operations utility

USAGE:
   tropo [global options] command [command options] [arguments...]

VERSION:
   0.2.0

COMMANDS:
   guid     tropo guid 9fb9f0887171a133e4ce14025baa968e
   list     tropo list features
   lookup   tropo lookup 9fb9f0887171a133e4ce14025baa968e
   help, h  Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --config, -c 'hosted'    config to use in ~/.tropo-api.cfg
   --version, -v        print the version
   --help, -h           show help

To do

• Handle auth errors better, currently its a giant stacktrace
• Add payment info https://api.aws.tropo.com/rest/v1/users/jdyer/payment/method

Lookup data

Lookup Features

$ tropo list features                                                                                                                                                                                                                             ±[●][master]
+----------+------------------------------+
| PROPERTY |            VALUE             |
+----------+------------------------------+
| s        | Outbound SIP                 |
| b        | SIP Bang Syntax              |
| c        | Override Caller id           |
| w        | International Outbound SMS   |
| i        | Internation    al Outbound Voice |
| u        | Domestic Outbound Voice      |
| d        | Domestic Outbound SMS        |
| r        | SIP REFER                    |
| x        | Disabled Account             |
+----------+------------------------------+

Decode sessionGUID

 $ tropo guid 9fb9f0887171a133e4ce14025baa968e
 Results: 10.6.69.185

Address

tropo lookup address +14433058696
Results
+---------------------+-----------------+
|      PROPERTY       |      VALUE      |
+---------------------+-----------------+
| Type                | number          |
| Prefix              | 1510            |
| Number              | +151021012345    |
| DisplayNumber       | +1 510-210-12345 |
| ServiceId           | 5150065         |
| City                | Crockett        |
| State               | CA              |
| Country             | United States   |
| ProviderName        | bw              |
| SmsEnabled          | true            |
| ExcludeFromBilling  | false           |
| SmsRateLimit        | 60              |
| ExchangeId          | 2584            |
| ApplicationId       | 5032096         |
| RequireVerification | false           |
+---------------------+-----------------+

User

tropo lookup user jdyer
Results
+------------------------+--------------------------------+
|        PROPERTY        |             VALUE              |
+------------------------+--------------------------------+
| Username               | jdyer                          |
| AccountId              | 29890                          |
| Email                  | jdyer@voxeolabs.com            |
| Name                   | John Dyer                      |
| Address                | 189 South Orange Avenue #1000  |
|                        | FL                             |
| JoinDate               | 2008-04-05T19:57:50.000+0000   |
| Status                 | active                         |
| Notes                  | none                           |
| PasswordFailedAttempts | 0                              |
+------------------------+--------------------------------+

Application

$ tropo lookup application 5032272
Results
+--------------+--------------------------------------------------------------------+
|   PROPERTY   |                               VALUE                                |
+--------------+--------------------------------------------------------------------+
| AppId        | 1234566                                                            |
| UserId       | 12345                                                              |
| App Name     | ppid832                                                            |
| Platform     | scripting                                                          |
| Environment  | http://api.aws.tropo.com/rest/v1/environments/461                  |
| MessagingUrl | https://dl.dropboxusercontent.com/u/1234/TROPO/app.rb              |
| VoiceUrl     | https://dl.dropboxusercontent.com/u/177285/TROPO/appMsg.rb         |
| Partition    | production                                                         |
+--------------+--------------------------------------------------------------------+

Multi-tennancy

Config

[DEFAULT]
host: api.aws.tropo.com
route: /rest/v1
protocol: https://
base-url: %(protocol)s%(host)s%(route)s

[hosted]
url: %(base-url)s
username: jdyer
password: abc

[customer1]
url: %(protocol)sapi2..tropo.com%(route)s
username: jdyer
password: abc

[customer2]
url: %(protocol)sapi3..tropo.com%(route)s
username: jdyer
password: abc

Disable SSL validation

Simply add the following at the global level, or per backend

 InsecureSkipVerify: true

Author

John Dyer

=======