See CarouselSMS.com/#documentation instead.
http://sl.carouselsms.com/api/
Format of Request: HTTP POST to endpoint with URL encoded parameters.
Format of Response: JSON.
Examples:
curl 'http://sl.carouselsms.com/api/send_message?api_key=API_KEY&body=test&phone_number=+1(347)264-3707'
{"message_ids":"5554055"}
curl 'http://sl.carouselsms.com/api/send_messages?api_key=API_KEY&template=Hello,%20%7B%7Bname%7D%7D&recipients=%7B%2213472643707%22:%7B%22name%22:%22Alex%22%7D,%221234567890%22:%7B%22name%22:%22Unknown%22%7D%7D'
{"message_ids":"5554173"}
* without encoding URL looks like: http://sl.carouselsms.com/api/send_messages?api_key=API_KEY&template=Hello, {{name}}&recipients={"13472643707": {"name": "Alex"}, "1234567890": {"name": "Unknown"}}
Every client Application (app) has an API key associated with it. This key is generated during the creation of the app and can be re-generated from the show/edit screens in the administrative console.
This key uniquely identifies an app during the calls the app does to the Service Layer (SL).
Types of parameters being passed with API calls and received as callbacks:
Regular text string.
Integer number, either positive or negative.
We are quite flexible with booleans. They are case-insensitive and can take the following shapes:
TRUE: 1, t, true, y, yesFALSE: 0, f, false, n, no
Dates and times parsing is very liberal in the SL. We are capable of parsing almost everything that can be interpreted as a date/time. Here are some examples of what the dates can look like:
16:30– takes current date as basis and uses provided timeAug 31– take current year, users the given date and sets time to 00:007/31– the same as above2/9/2007or2007-02-09– date only02-09-2007 12:30:44 AMor2007-09-02T00:30:44Z- UTC (GMT) time02-09-2007 12:30:44 PM ESTor2007-09-02T12:30:44-0500- localized timeWednesday, January 10, 2001- human-readable date
If you need a stricter definition, you can refer to RFC2822 (3.3. Date and Time Specification).
The SL uses a series of modules to provide basic business logic for applications.
The following links provide detailed documentation on callbacks.
- Handset, Phone: an end-user's mobile phone.
- MT (Mobile Terminated): outgoing message from our system to a handset.
- MO (Mobile Originated): incoming message from a handset to our system.
- DID (Direct Inward Dialing): the term we use for virtual numbers or long codes. These are 10-digit phone numbers in the United States.
- SMSC (Short Message Service Center): the point in the stack which stores and delivers text messages. In our case, we use internal SMSCs which can be made up of one DID or many. Multiple DIDs allow for threaded conversations and higher throughput.
The Carousel API documents are Copyright © 2013 Recess Mobile.