{"_id":"55650b9fb893840d00444704","__v":9,"category":{"_id":"55650b9fb893840d00444702","version":"55650b9eb893840d00444701","pages":["55650b9fb893840d00444704","55662e121ec2311900e4c538","55663058f579050d00c3d42d","556633b61ec2311900e4c544","55663419f579050d00c3d43f","55663490979a3c2500bbafa6","5566352a979a3c2500bbafa8","55663578979a3c2500bbafab","556635fd1ec2311900e4c551","5566365a979a3c2500bbafb3","556636daf579050d00c3d448","5568d269c87afd2500e5254c","556b5b46ab693b1900ce1722","556bbee230922f1700ad5e22","5578af9327f77c0d00fe62ce","567328a458c4890d00bb545f"],"project":"55650b9eb893840d004446fe","__v":16,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-05-27T00:11:11.144Z","from_sync":false,"order":9999,"slug":"documentation","title":"Documentation"},"parentDoc":null,"project":"55650b9eb893840d004446fe","user":"5564f227f0f70f0d00a9ab20","version":{"_id":"55650b9eb893840d00444701","project":"55650b9eb893840d004446fe","__v":2,"createdAt":"2015-05-27T00:11:10.647Z","releaseDate":"2015-05-27T00:11:10.647Z","categories":["55650b9fb893840d00444702","5566a1557acd550d0075e894"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-05-27T00:11:11.861Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Base URI: http(s)://meshblu-http.octoblu.com\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Web Browser Bundle\",\n  \"body\": \"You may include meshblu-http in your webbrowser by using the following link:\\n\\n[https://cdn.octoblu.com/js/meshblu-http/latest/meshblu-http.bundle.js](https://cdn.octoblu.com/js/meshblu-http/latest/meshblu-http.bundle.js)\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"body\": \"Most of our API endpoints require authentication credentials (UUID and secret token) passed in the HTTP headers as meshblu_auth_uuid and meshblu_auth_token respectively.\",\n  \"title\": \"Authentication\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Content-Type\",\n  \"body\": \"If you are posting JSON in the body, you must set the Content-Type: application/json\"\n}\n[/block]\nThese credentials are generated by registering a device or user with Meshblu via the [POST /Devices](/v1.0/docs/devices#devices) API (see below). If you would like to associate additional Meshblu devices to the UUID and Token that you created (as a user), you can add an \"owner\" property to your other devices with the user's UUID as its value.\n\nWe support the following device permissions: View/Discover, Send Messages, and Configure. These permissions are manageable by adding UUIDs to whitelists and blacklists arrays with the following names: viewWhitelist, viewBlacklist, sendWhitelist, sendBlacklist, updateWhitelist, updateBlacklist. Note: If your UUID is the same as the \"owner\" UUID, these permissions are not enforced (you are the owner).","excerpt":"This page will help you get started with Meshblu HTTP. You'll be up and running in a jiffy!","slug":"getting-started","type":"basic","title":"Getting Started"}

Getting Started

This page will help you get started with Meshblu HTTP. You'll be up and running in a jiffy!

[block:api-header] { "type": "basic", "title": "Base URI: http(s)://meshblu-http.octoblu.com" } [/block] [block:callout] { "type": "info", "title": "Web Browser Bundle", "body": "You may include meshblu-http in your webbrowser by using the following link:\n\n[https://cdn.octoblu.com/js/meshblu-http/latest/meshblu-http.bundle.js](https://cdn.octoblu.com/js/meshblu-http/latest/meshblu-http.bundle.js)" } [/block] [block:callout] { "type": "danger", "body": "Most of our API endpoints require authentication credentials (UUID and secret token) passed in the HTTP headers as meshblu_auth_uuid and meshblu_auth_token respectively.", "title": "Authentication" } [/block] [block:callout] { "type": "warning", "title": "Content-Type", "body": "If you are posting JSON in the body, you must set the Content-Type: application/json" } [/block] These credentials are generated by registering a device or user with Meshblu via the [POST /Devices](/v1.0/docs/devices#devices) API (see below). If you would like to associate additional Meshblu devices to the UUID and Token that you created (as a user), you can add an "owner" property to your other devices with the user's UUID as its value. We support the following device permissions: View/Discover, Send Messages, and Configure. These permissions are manageable by adding UUIDs to whitelists and blacklists arrays with the following names: viewWhitelist, viewBlacklist, sendWhitelist, sendBlacklist, updateWhitelist, updateBlacklist. Note: If your UUID is the same as the "owner" UUID, these permissions are not enforced (you are the owner).