{"action":"closed","issue":{"url":"https://api.github.com/repos/daisy/DAISY-Online-Refresh/issues/2","labels_url":"https://api.github.com/repos/daisy/DAISY-Online-Refresh/issues/2/labels{/name}","comments_url":"https://api.github.com/repos/daisy/DAISY-Online-Refresh/issues/2/comments","events_url":"https://api.github.com/repos/daisy/DAISY-Online-Refresh/issues/2/events","html_url":"https://github.com/daisy/DAISY-Online-Refresh/issues/2","id":41047130,"number":2,"title":"Requirement 2: Setup of service URLs","user":{"login":"jabbors","id":1805094,"avatar_url":"https://avatars.githubusercontent.com/u/1805094?v=3","gravatar_id":"","url":"https://api.github.com/users/jabbors","html_url":"https://github.com/jabbors","followers_url":"https://api.github.com/users/jabbors/followers","following_url":"https://api.github.com/users/jabbors/following{/other_user}","gists_url":"https://api.github.com/users/jabbors/gists{/gist_id}","starred_url":"https://api.github.com/users/jabbors/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jabbors/subscriptions","organizations_url":"https://api.github.com/users/jabbors/orgs","repos_url":"https://api.github.com/users/jabbors/repos","events_url":"https://api.github.com/users/jabbors/events{/privacy}","received_events_url":"https://api.github.com/users/jabbors/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/daisy/DAISY-Online-Refresh/labels/enhancement","name":"enhancement","color":"84b6eb"}],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":5,"created_at":"2014-08-25T09:44:52Z","updated_at":"2015-01-29T09:59:53Z","closed_at":"2015-01-29T09:59:53Z","body":"**Origin**\r\n[Requirement 2: Setup of service URLs] (https://github.com/daisy/DAISY-Online-Refresh/wiki/DODPRequirementsAnalysis#Requirement_2_Setup_of_service_URLs)\r\n\r\n**What**\r\nCurrently there is no method to support configuring the DAISY Online URL for a device. We require the ability for a unique device ID to be used to return the service URL to the device.\r\n\r\n**Why**\r\nThis allows devices to be pre-configured to a general discovery service negating the requirement to have devices pre-configured by the vendor to a particular DAISY Online service.\r\n\r\n**Notes/Comments**\r\n\r\n### How\r\n\r\n#### Configuration of Service URLs\r\n\r\nWhen a Reading System is not configured to connect to a Service Provider, it will download the list of available service providers from the Daisy Consortium website, and use it to present the user with list of available service providers available to them, ordered logically using the machines current geolocation (if available) and Reading System Language when it first logs on to the internet.\r\n\r\nWhen a Reading System is configured with a Service Provider URL this option should be available to the user through the UI.\r\n\r\n#### Service URL XML Returned\r\n\r\nThe Service URL list will be centrally hosted by the Daisy Consortium. A service provider can apply to the Consortium to be added to the list, once the URL and details are confirmed and the service is verified by the consortium, the list will be updated.\r\n\r\n#### Reading System List\r\n\r\nThe list will also contain a list of approved Reading Systems and their Public keys for autoconfiguration encryption.\r\n\r\n#### XML Elements\r\n\r\nRequired\r\n\r\nFor Services:\r\n```<name></name>```  Name of the Service provider\r\n```<url></url>```  DODP Service URL\r\n ```<country></country>``` Country of the Service Provider\r\n```<language></language> ```Language of the collection\r\n```<latitude></latitude> ```GPS Information\r\n```<longitude></longitude> ```GPS information\r\n\r\nFor Reading Systems:\r\n```<manufacturer></manufacturer> ```\r\n```<public-key></public-key> ```\r\n\r\nOptional\r\n\r\nFor Services:\r\n ```<website></website> ```Public website of the service provider\r\n``` <phone></phone> ```Telephone number of the service provider\r\n``` <email></email> ```Contact email for the service provider\r\n\r\nFor Reading Systems:\r\n```<model></model> ```\r\n\r\n#### Sample XML\r\n```\r\n<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n<service-list> \r\n<!-- Vision Australia -->\r\n <service> \r\n <name>Vision Australia</name> \r\n <url>https://something.visionaustralia.org/service.svc</url> \r\n <website>http://www.visionaustralia.org/</website>\r\n <phone>611300654656</phone>\r\n <country>au</country> \r\n <languages> \r\n <language>en</language> \r\n </languages> \r\n <latitude>-37.8471942</latitude>\r\n <longitude>145.0082843,13</longitude> \r\n </service> \r\n<!-- CNIB -->\r\n <service>\r\n <name>CNIB</name> \r\n <url>https://something.cniblibrary.com/DaisyOnlineService/DaisyOnlineService</url> \r\n <website>http://www.cniblibrary.com/</website>\r\n <phone>611300654656</phone>\r\n <country>ca</country> \r\n <languages> \r\n <language>en</language> \r\n <language>fr</language> </languages> \r\n <latitude>43.717457</latitude> \r\n <longitude>-79.3779645,17</longitude> \r\n </service> \r\n </service-list>\r\n<reading-system-list> \r\n <reading-system>\r\n <manufacturer>Shinano Kenshi Co.,Ltd.</manufacturer>\r\n <model>PTX1Pro</model>\r\n <public-key>http://daisy.plextalk.com/key</public-key>\r\n</reading-system>\r\n</reading-system-list> \r\n```"}}