{"__v":3,"_id":"55f28174f9f3991900f38a28","category":{"__v":2,"_id":"55f28172f9f3991900f38a14","pages":["55f28174f9f3991900f38a28","55f2859fec95bb0d00696669"],"project":"54ebb40d6423300d003672c0","version":"55f28172f9f3991900f38a13","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-02-23T23:13:18.226Z","from_sync":false,"order":0,"slug":"http-remote-control-api","title":"HTTP Remote Control API"},"project":"54ebb40d6423300d003672c0","user":"557e2561eb75d80d00af3dab","version":{"__v":2,"_id":"55f28172f9f3991900f38a13","project":"54ebb40d6423300d003672c0","createdAt":"2015-09-11T07:23:30.065Z","releaseDate":"2015-09-11T07:23:30.065Z","categories":["55f28172f9f3991900f38a14","55f28172f9f3991900f38a15","55f28172f9f3991900f38a16","55f66acb297b37170058accb"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-06-17T04:05:20.071Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"The LIFX HTTP API lets you control LIFX devices over the internet. To communicate directly with a LIFX device over the local Wi-Fi network, see the [LIFX LAN Protocol documentation](https://lan.developer.lifx.com).\n\nThe LIFX HTTP API is [REST](http://en.wikipedia.org/wiki/Representational_state_transfer) inspired API for interacting with LIFX devices. Where other APIs may be concerned with managing resources, our API has been designed around messaging physical lights to perform actions.\n\nWe use familiar HTTP conventions such as verbs, meaningful URLs, authentication and status codes for easily consuming the API with off-the-shelf clients. All responses are returned as JSON.\n\n[Cross-Origin Resource Sharing](http://en.wikipedia.org/wiki/Cross-origin_resource_sharing) (CORS) is supported allowing you to consume the API entirely from client-side web applications. This document uses CORS for allowing you to test endpoints right from your browser. Special care should be taken to prevent leaking access tokens when using CORS.\n\nAs with all online services, there are occasionally disruptions which may cause the API to be unavailable. These can occur for both planned maintenance or unplanned incidents. To follow the latest status of our API please see our [status page](http://status.lifx.com/).\n\nIf you have any feedback or questions, we'd love to hear from you on our [community forum](https://community.lifx.com)!\n\nAll examples in this document use non-genuine access tokens and serial numbers.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Terms and Conditions\"\n}\n[/block]\nLiFi Labs, Inc. © 2015. All rights reserved. Usage of this documentation is bound by the [LIFX Developer Terms](http://www.lifx.com/pages/developer-terms-of-use).","excerpt":"","slug":"introduction","type":"basic","title":"Introduction"}
The LIFX HTTP API lets you control LIFX devices over the internet. To communicate directly with a LIFX device over the local Wi-Fi network, see the [LIFX LAN Protocol documentation](https://lan.developer.lifx.com). The LIFX HTTP API is [REST](http://en.wikipedia.org/wiki/Representational_state_transfer) inspired API for interacting with LIFX devices. Where other APIs may be concerned with managing resources, our API has been designed around messaging physical lights to perform actions. We use familiar HTTP conventions such as verbs, meaningful URLs, authentication and status codes for easily consuming the API with off-the-shelf clients. All responses are returned as JSON. [Cross-Origin Resource Sharing](http://en.wikipedia.org/wiki/Cross-origin_resource_sharing) (CORS) is supported allowing you to consume the API entirely from client-side web applications. This document uses CORS for allowing you to test endpoints right from your browser. Special care should be taken to prevent leaking access tokens when using CORS. As with all online services, there are occasionally disruptions which may cause the API to be unavailable. These can occur for both planned maintenance or unplanned incidents. To follow the latest status of our API please see our [status page](http://status.lifx.com/). If you have any feedback or questions, we'd love to hear from you on our [community forum](https://community.lifx.com)! All examples in this document use non-genuine access tokens and serial numbers. [block:api-header] { "type": "basic", "title": "Terms and Conditions" } [/block] LiFi Labs, Inc. © 2015. All rights reserved. Usage of this documentation is bound by the [LIFX Developer Terms](http://www.lifx.com/pages/developer-terms-of-use).