RestYourDroid is an android app that allows you to control your device remotely via a REST api.
Download the app:

Local (free)
Access device from
the local network 		Global ($1)
Access from anywhere
on the internet

acceleration

Measures the acceleration force in m/s2 that is applied to a device on all three physical axes (x, y, and z).
GET /acceleration
parameters:
include_gravity Include gravity in the acceleration force default="true"

Example usage


curl
jquery

Example result












battery



Return the battery charge and status. 




GET /battery










Example usage



curl
jquery

Example result












camera



Take a picture with the phone's camera. 




GET /camera

 parameters:


 

binary
Download the image in binary format (or in base 64 encoding)
default="true"


 

front
Use the front camera
default="false"


 

width
Width of the image
default="2048"


 

exposure
Exposure compensation
default="0"


 









Example usage



curl
jquery

Example result












contacts



Retrieve all contacts on the device. 




GET /contacts










Example usage



curl
jquery

Example result












files



Browse and download files on the external storage. 




GET /files

 parameters:


 

path
Path of the directory or file
default="/"


 

binary
Download the file in binary format (or in base 64 encoding)
default="true"


 









Example usage



curl
jquery

Example result












gravity



Measures the force of gravity in m/s2 that is applied to a device on all three physical axes (x, y, z). 




GET /gravity










Example usage



curl
jquery

Example result












gyroscope



Measures a device's rate of rotation in rad/s around each of the three physical axes (x, y, and z). 




GET /gyroscope










Example usage



curl
jquery

Example result












humidity



Measures the relative ambient humidity in percent (%). 




GET /humidity










Example usage



curl
jquery

Example result












light



Measures the ambient light level (illumination) in lux. 




GET /light










Example usage



curl
jquery

Example result












location



Return location information. 




GET /location

 parameters:


 

accuracy
Minimum accuracy in meters.
default="100"


 









Example usage



curl
jquery

Example result












magnetism



Measures the ambient geomagnetic field for all three physical axes (x, y, z) in μT. 




GET /magnetism










Example usage



curl
jquery

Example result












notify



Show a notification on the device. 




POST /notify

 parameters:


 

text
Text of the notification
default="Hello world!"


 

title
Title of the notification
default="Hi"


 

vibrate
Vibrate the phone
default="true"


 

sound
Play a sound
default="true"


 









Example usage



curl
jquery

Example result












poll_init



Ask the user to choose between a number of alternatives. 




POST /poll_init

 parameters:


 

id
A unique id for this poll
default="123456"


 

title
Title
default="Please choose your pizza"


 

text
Text
default="Choose before 11am, please pay Franco"


 

options
JSON list of the lists of options and their titles
default="{"Pizza type":["Margerita","Hawaiian","BBQ Chicken","Veggie","Meat special","<custom>"],"size":["small","medium","large"]}"


 

vibrate
Vibrate the phone
default="true"


 

sound
Play a sound
default="true"


 









Example usage



curl
jquery

Example result












poll_result



Retrieve the result from a poll. 




GET /poll_result

 parameters:


 

id
The unique id of the poll
default="123456"


 









Example usage



curl
jquery

Example result












pressure



Measures the ambient air pressure in hPa or mbar. 




GET /pressure










Example usage



curl
jquery

Example result












proximity



Measures the proximity of an object in cm relative to the view screen of a device. This sensor is typically used to determine whether a handset is being held up to a person's ear. 




GET /proximity










Example usage



curl
jquery

Example result












ram



Return RAM usage. 




GET /ram










Example usage



curl
jquery

Example result












rotation



Measures the orientation of a device by providing the three elements of the device's rotation vector. 




GET /rotation










Example usage



curl
jquery

Example result












speech



Make the phone speak a given text using the text-to-speech engine. 




POST /speech

 parameters:


 

text
The text to speak
default="I'm sorry Dave, I'm afraid I can't do that."


 

language
Language of the text
default="en"


 









Example usage



curl
jquery

Example result












temperature



Measures the temperature of the device in degrees Celsius (°C). 




GET /temperature










Example usage



curl
jquery

Example result












text



Send a text message (sms). 

 careful: This method might incur additional carrier charges.



POST /text

 parameters:


 

number
Telephone number
default="0032494060673"


 

message
Text message
default="Hi Koen. Thanks for building this API!"


 









Example usage



curl
jquery

Example result












texts



Retrieve all texts (sms messages) on your phone. 




GET /texts










Example usage



curl
jquery

Example result












url



Play a url on the phone 




POST /url

 parameters:


 

url
The url to open on the android device
default="http://www.youtube.com/watch?v=dQw4w9WgXcQ"


 









Example usage



curl
jquery

Example result












vibrate



Activate the vibrator. 




POST /vibrate

 parameters:


 

duration
Duration of the vibration
default="500"


 









Example usage



curl
jquery

Example result












meta



Describe all api methods and their parameters 




GET /meta










Example usage



curl
jquery

Example result