Difference between revisions of "ASL HTTP InformationRetrieval"

From Gcube Wiki
Jump to: navigation, search
(listing of searchable collections)
Line 1: Line 1:
 
The ASL HTTP Information Retrieval component is part of the [[Integration_and_Interoperability_Facilities_Framework:_HTTP_API_Framework_Specification | HTTP Front End Framework]] and provides aggregated access to mandated functionality for performing a gCube search. It follows the all the framework principles for data interchange formats, error handling, and context management, supporting both JSON and XML, using the common framework utilities for user authentication and HTTP error responses, supporting all authentication modes and following the suggested design patterns for scope management and session management as well as coding guidelines. The features provided are listed as follows:
 
The ASL HTTP Information Retrieval component is part of the [[Integration_and_Interoperability_Facilities_Framework:_HTTP_API_Framework_Specification | HTTP Front End Framework]] and provides aggregated access to mandated functionality for performing a gCube search. It follows the all the framework principles for data interchange formats, error handling, and context management, supporting both JSON and XML, using the common framework utilities for user authentication and HTTP error responses, supporting all authentication modes and following the suggested design patterns for scope management and session management as well as coding guidelines. The features provided are listed as follows:
 
==listing of searchable collections==
 
==listing of searchable collections==
 +
Once logged in to a scope (either in named or anonymous access), the user is able to get the list of the available, searchable collections in the corresponding VO/VRE. By submitting a GET request to the ShowCollections servlet of the InformationRetrieval group of services, the user can retrieve an XML or a JSON representation of the list that aggregates the necessary information for the accessible collections.
 +
 +
* Parameters needed: none
 +
* URL request example:
 +
* Response in XML:
 +
* Response in JSON:
 +
 
==retrieval of information about searchable collections==
 
==retrieval of information about searchable collections==
 
==listing of search types==
 
==listing of search types==

Revision as of 11:03, 28 August 2012

The ASL HTTP Information Retrieval component is part of the HTTP Front End Framework and provides aggregated access to mandated functionality for performing a gCube search. It follows the all the framework principles for data interchange formats, error handling, and context management, supporting both JSON and XML, using the common framework utilities for user authentication and HTTP error responses, supporting all authentication modes and following the suggested design patterns for scope management and session management as well as coding guidelines. The features provided are listed as follows:

listing of searchable collections

Once logged in to a scope (either in named or anonymous access), the user is able to get the list of the available, searchable collections in the corresponding VO/VRE. By submitting a GET request to the ShowCollections servlet of the InformationRetrieval group of services, the user can retrieve an XML or a JSON representation of the list that aggregates the necessary information for the accessible collections.

  • Parameters needed: none
  • URL request example:
  • Response in XML:
  • Response in JSON:

retrieval of information about searchable collections

listing of search types

listing of languages

listing of searchable fields

submission of search query

retrieval of search results