Atmosphere® API Basics
Keep these basics in mind and you’ll be set up for success with the Atmosphere® API.
The Basics
Authentication
All API calls require an authentication token. Learn more here: Atmosphere® API Authentication
Content Type
All API POST requests require the content-type header set to application/json.
Protocol
All API requests must be made with HTTPS.
The Formats
Long Code Format
- Supply a long code (or telephone number) in E.164 format.
- In the URL, the “+” of the E.164 format should be url-encoded as “%2B”.
Short Code and Alphanumeric Sender ID Format and Examples
- Supply a short code or alphanumeric sender ID in the following format: {countrycode}-{code}
- countrycode is the country code from where the shortcode or alphanumeric sender ID resides
- code is the actual code
- A USA short code (88888) would be 1-88888
- A Colombia shortcode (12345) would be 57-12345
- A Spain Alphanumeric Sender ID (Hello8) would be 34-Hello8
Security
Legacy TLS version 1.1 and SSLv3 are not supported.