You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Story ID

sto_60

Name

Retrieving data via REST API

User role

DataPublisher


Description

I want to get data contained in private dataset via REST API so that I can write an application that consumes such data.

Preconditions

  • dataset exists in internal catalog with resource created and available via REST API

Acceptance criteria

  • clicks the selected dataset 'Name' in the list of catalog records in internal catalog
    • list of available resources for a dataset are displayed
  • clicks to resource 'Name' or selects 'Preview' from 'Explore' combo box of a resource presented as a resource dedicated for REST API
    • if clicks to resource 'Name' or selects 'More information' from 'Explore' combo box
      • metadata fields about dataset resource are displayed according to DCAT/VoID specification 
      • REST API base URL is displayed
      • 'Data API' button is available
      • clicks 'Data API' button
      • REST API documentation is displayed within resource description including
        • scheme of the dataset - list of all columns (see preview)
        • URL for get all IDs type of request 
        • URL for get data for one ID type of request (ID is chosen automatically - random) including HTTP header of request 
        • corresponding response to get data for one ID request with random ID including HTTP header and data returned
        • show examples of other types of REST API requests (including HTTP headers) with URLs directly usable including corresponding responses (with real data and HTTP headers)

-----------------------------------------------------

  • external code calls the REST API (REST service) of the public catalog according to documentation provided (two types of requests supported: get all IDs, get data for one ID)
  • REST API returns JSON representation of data contained in a dataset

Requirements

TODO

Notes

  • No labels