SendTab
SendTab API
The super simple SendTab API allows developers to build SendTab functionality into third party applications. Send and receive tabs like a pro. SendTab uses a RESTful API style - to execute a command, simply load the appropriate URL. The command result will be returned as a JSON object.
Sample PHP code for sending and receiving tabs is available here.
SendTab API calls take the form:
http://sendtab.com/api3/command?auth=$authstring&from=$node_name
Authentication
All SendTab API calls require an authentication string. This string is an MD5 hash of the lowercased SendTab network name and network password.
// in PHP, generate the auth string like so:
$authstring = md5(strtolower($username) . $password);
Get a list of nodes in the SendTab network
To get a list of the existing nodes in a SendTab network, use the getnames command. You must specify a from parameter, which identifies the node from which the command is being issued. The node specified in the from parameter will NOT be included in the results. This command will return a JSON array of valid node names.
http://sendtab.com/api3/getnames?auth=$auth&from=$from
Add a new device to the network
New device nodes are created automatically upon their first login to a network. Thus, to create a new node, send it's name in the comp_name parameter along with a network name and password to the login endpoint.
http://sendtab.com/api3/login?name=My Network&password=My Password&comp_name=My New Device
Send a Tab
To send a tab, use the put command with the tab's URL as the link parameter, the name of the originating node as the from parameter, and a optionally the name of the recipient node as the to parameter.
Make sure to properly urlencode your link parameter.
Send a tab to one specific node:
http://sendtab.com/api3/put?auth=$auth&from=$from&to=$to&link=$link
Send a tab to all nodes in a network:
http://sendtab.com/api3/put?auth=$auth&from=$from&link=$link
If the request was successful, the API will return a JSON object with the field status set to OK.
If for any reason the request fails, the API will return a JSON object with the field status set to FAIL.
Check for a new tab
To check if a new tab is waiting in the queue, use the get command, and pass in the current node's name in the from parameter.
http://sendtab.com/api3/get?auth=$auth&from=$from
If a tab is waiting, the API will return a JSON object where the field status contains the URL of the new tab.
If no tab is waiting, the API will return a JSON object where the field status is blank.