{"_id":"55e9772c8b72bb3700b1d5b8","user":"55c9b7b4e4927a0d0004a727","__v":8,"category":{"_id":"55e06ae66bad670d0081f25c","project":"55e06494a44fae0d002146aa","pages":["55e06b2358c5460d0076aa0f","55e06b33a44fae0d002146c5","55e06b4058c5460d0076aa11","55f9624d3bb4bb0d0022d188","56277cafe2ce610d004e3ebc","56277cb83a4c6b0d00c4555f","56277cc444c87f0d00fe6480","56277ccee2ce610d004e3ebe"],"version":"55e06495a44fae0d002146ad","__v":8,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-08-28T14:06:30.305Z","from_sync":false,"order":14,"slug":"os-routes-coming-soon","title":"OS Routes (Beta)"},"project":"55e06494a44fae0d002146aa","parentDoc":null,"version":{"_id":"55e06495a44fae0d002146ad","project":"55e06494a44fae0d002146aa","__v":54,"createdAt":"2015-08-28T13:39:33.907Z","releaseDate":"2015-08-28T13:39:33.907Z","categories":["55e06496a44fae0d002146ae","55e06997a44fae0d002146c2","55e06a6958c5460d0076aa0c","55e06ae66bad670d0081f25c","55e06cc1a44fae0d002146cb","55e06ddda44fae0d002146cd","55e95f261fd7e82300ef359f","55e95fe47fc27b2d00d32cfa","55e96eef358d923700be984d","55e96ef6358d923700be984e","55e96efda7ca823900ad547e","55e96f04a7ca823900ad547f","55e970cc358d923700be9853","55e973f4358d923700be9858","55e973f9a7ca823900ad548c","55e977bf358d923700be985d","55e9780f8b72bb3700b1d5bd","55e97815a7ca823900ad5493","55e9781c358d923700be985f","55e97821461e2a390050f23b","55f963c23bb4bb0d0022d18c","5624c67406e8040d005ed6b2","5624dcf25a86b423009462e8","5625f229d0f87e190014c4ed","5627819fe2ce610d004e3ec8","562781b23a4c6b0d00c4556b","5627837166c62617009d17e2","5627851efcbbc621004ebff1","5627860044c87f0d00fe6491","562e3c6d54a5be0d00070c3e","564c955aae6cb82100dc137a","5652e22abbe7110d00dba748","5652f25523d4262d00b21c58","5652fdad51e4e81900bf2452","5652fdcbb60abb1700bafadc","5654494f65bec717007e0293","565da11a77f0090d005818ff","565f063f413e06170093de18","565f06fb413e06170093de21","56dd6773efaca42900e5f58e","56dd68630c3bb41700b0b037","56dd7d24d5419f170075dfb3","56dd9448c117291700015b60","56dd9454c117291700015b61","577a6f8b9748b80e00ef3f45","577a6f969748b80e00ef3f46","577bba7f6e5f301900fada99","57a9cc8e5b1ace0e00de743f","58aab134c50c33250046b8f8","58aab146aecc3e2500573d4c","58aab1628f862f250076f92e","58aab1938f862f250076f92f","58aab3e5aecc3e2500573d56","58aab3f2aecc3e2500573d57"],"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-09-04T10:49:16.335Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Authentication\"\n}\n[/block]\nAuthentication uses the “key” parameter followed by the customer’s API key. All requests must be made over HTTPS.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Use your own API Key\",\n  \"body\": \"Throughout our documentation you can use your own API key wherever you read YOUR_APP_KEY to run the examples we provide. Simply [sign up for a free trial](https://developer.os.uk) and enter the key when prompted. The key automatically populates the examples, so you only need to do this once.\\n\\nCurrently your app key is set to: [[app:key]]\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Encoding\"\n}\n[/block]\nAll requests must be encoded correctly according to standard [percent-encoding](http://www.w3schools.com/tags/ref_urlencode.asp) procedures for a URI.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"What are the response codes?\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Official description\",\n    \"0-0\": \"200\",\n    \"0-1\": \"OK\",\n    \"h-2\": \"Explanation in context of the API\",\n    \"1-0\": \"400\",\n    \"2-0\": \"401\",\n    \"3-0\": \"404\",\n    \"4-0\": \"405\",\n    \"5-0\": \"500\",\n    \"1-1\": \"Bad request\",\n    \"2-1\": \"Unauthorized\",\n    \"3-1\": \"Not found\",\n    \"4-1\": \"Method not allowed\",\n    \"6-0\": \"503\",\n    \"5-1\": \"Internal server error\",\n    \"6-1\": \"Service unavailable\",\n    \"0-2\": \"Request has been successful.\",\n    \"1-2\": \"E.g. missing query parameter, malformed syntax.\",\n    \"2-2\": \"The client has not provided authentication or incorrect authentication.\",\n    \"3-2\": \"The server has not found anything matching the Request-URI.\",\n    \"4-2\": \"Request used an unsupported HTTP method, e.g. DELETE or PUT.\",\n    \"5-2\": \"Generic internal server error.\",\n    \"6-2\": \"E.g. due to overloading or maintenance.\"\n  },\n  \"cols\": 3,\n  \"rows\": 7\n}\n[/block]","excerpt":"","slug":"os-routes-technical-detail","type":"basic","title":"Technical detail"}
[block:api-header] { "type": "basic", "title": "Authentication" } [/block] Authentication uses the “key” parameter followed by the customer’s API key. All requests must be made over HTTPS. [block:callout] { "type": "info", "title": "Use your own API Key", "body": "Throughout our documentation you can use your own API key wherever you read YOUR_APP_KEY to run the examples we provide. Simply [sign up for a free trial](https://developer.os.uk) and enter the key when prompted. The key automatically populates the examples, so you only need to do this once.\n\nCurrently your app key is set to: [[app:key]]" } [/block] [block:api-header] { "type": "basic", "title": "Encoding" } [/block] All requests must be encoded correctly according to standard [percent-encoding](http://www.w3schools.com/tags/ref_urlencode.asp) procedures for a URI. [block:api-header] { "type": "basic", "title": "What are the response codes?" } [/block] [block:parameters] { "data": { "h-0": "Code", "h-1": "Official description", "0-0": "200", "0-1": "OK", "h-2": "Explanation in context of the API", "1-0": "400", "2-0": "401", "3-0": "404", "4-0": "405", "5-0": "500", "1-1": "Bad request", "2-1": "Unauthorized", "3-1": "Not found", "4-1": "Method not allowed", "6-0": "503", "5-1": "Internal server error", "6-1": "Service unavailable", "0-2": "Request has been successful.", "1-2": "E.g. missing query parameter, malformed syntax.", "2-2": "The client has not provided authentication or incorrect authentication.", "3-2": "The server has not found anything matching the Request-URI.", "4-2": "Request used an unsupported HTTP method, e.g. DELETE or PUT.", "5-2": "Generic internal server error.", "6-2": "E.g. due to overloading or maintenance." }, "cols": 3, "rows": 7 } [/block]