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