{"_id":"575676128749830e00681e98","__v":0,"isReference":true,"slug":"getting-started-with-retailer-api","updates":[],"api":{"url":"","results":{"codes":[]},"settings":"","auth":"required","params":[]},"body":"## Retailer API ##\n\nThe Retailer API is a RESTful API that provides a set of routines which enable the retailers to perform a set of operations against urb-it (validate and create urb-it orders and check pick-up locations' opening hours). Being implemented using open web technologies and standards, the retailer API can be accessed from different environments and on different platforms.\n\nThe API identifies urb-it retailers' applications using a custom authorization method [urb-it Web Authorization UWA](doc:authorizing-requests-1) to verify both the authentication and the data integrity. Every HTTP request must have the HTTP Authorization Header set up as described in the [Authorization](doc:authorizing-requests-1)  section. All the requests must send it via HTTPS. The endpoints refuses HTTP requests.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/IicFBg1wT4q2bXyDHZkE_flow.JPG\",\n        \"flow.JPG\",\n        \"1553\",\n        \"1157\",\n        \"#1b2f45\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n## [API Versioning](doc:api-versioning) ##\nAPI Versioning is used to specify the **version** for each **request **and **response**.  Endpoint version can be seen in the above example in the Accept header parameter. In case the version is not present, the the request is directed to the latest version of the endpoint. In case a new version is released and the version is not present, the exiting code might stop working.\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Required\",\n  \"body\": \"[Api Versioning](doc:api-versioning) is required for a lasting integration with urb-it!\"\n}\n[/block]","category":"575676128749830e00681e83","hidden":false,"link_external":false,"parentDoc":null,"version":"575676128749830e00681e82","excerpt":"This page will help you get started with the urb-it integration.","order":1,"createdAt":"2016-02-29T12:14:04.319Z","githubsync":"","link_url":"","project":"55a4d5531a5f991700a9409e","sync_unique":"","title":"Getting Started with Retailer API","type":"basic","user":"55a8e7abc8bd450d000dd0e5","childrenPages":[]}