---+ODS Dataspace OAuth-Simple Web Discovery (SWD) Guide

---++What

Simple Web Discovery (SWD) defines a HTTPS GET based mechanism to discover the location of a given type of service for a given principal starting only with a domain name.

---++Why

Promotes short way of gathering services data by minimizing the requirements for shared understanding.

--++How

Simple Web Discovery requests use the <b>x-www-form-urlencoded</b> format to specify a URI for the principal and another URI for the type of service being sought. If the request is successful then the response, by default, is a JSON object containing an array of URIs that point to where the principal has instances of services of the requested type. For the ODS Dataspace realm, these URIs point to the respective ODS Dataspace Application instance depending on the service of the requested type, which can be:

   * <b>weblog</b>,
   * <b>subscriptions</b>,
   * <b>wiki</b>,         
   * <b>briefcase</b>,    
   * <b>mail</b>,         
   * <b>photos</b>,       
   * <b>community</b>,    
   * <b>bookmak</b>,      
   * <b>polls</b>,        
   * <b>addressbook</b>,  
   * <b>calendar</b>


---+++Curl Examples


   * [[ODSManageOAuthWGEx1][Weblog]]
   * [[ODSManageOAuthWGEx2][Feeds]]
   * [[ODSManageOAuthWGEx3][Wiki]]
   * [[ODSManageOAuthWGEx4][Briefcase]]
   * [[ODSManageOAuthWGEx5][Mail]]
   * [[ODSManageOAuthWGEx6][Gallery]]
   * [[ODSManageOAuthWGEx7][Community]]
   * [[ODSManageOAuthWGEx8][Bookmarks]]
   * [[ODSManageOAuthWGEx10][Polls]]
   * [[ODSManageOAuthWGEx11][AddressBook]]                      
   * [[ODSManageOAuthWGEx13][Calendar]]                        

      

---++Related

   * [[http://self-issued.info/docs/draft-jones-simple-web-discovery-00.html][Simple Web Discovery (SWD)]]
   * [[ODSManageOAuthFeatures][ODS OAuth Supported Features]]