Search Data API
Revision as of 00:48, 2 March 2021 by Mnelson (talk | contribs) (Created page with "Category:WebService = Overview = = API = == Path == {| class="wikitable" |- |style="background-color:#eaecf0"|<b>Entry Point</b>|| <b> /ws/public/datasearch</b> |- |...")
Contents
Overview
API
Path
| Entry Point | /ws/public/datasearch |
| Access | Public |
| Http Method | GET |
| Response Format | JSON |
| Response Statuses | 200 - Success 401 - Unauthorized (if access has been restricted) 500 - Server Error |
Query Parameters
| Request Parameter | Purpose | Allowed Values |
|---|---|---|
| query | The search text | Any values allowed |
| auto | If true the response are valid autocomplete options, if false the response is the search results | true/false |
Auto Complete Response
The response is a JSON array of search options based on the query term
Example: /ws/public/datasearch?query=money&auto=true
[ "Claims on central government (annual growth as % of broad money)", "Claims on private sector (annual growth as % of broad money)", "Broad money (current LCU)","Money (current LCU)", "Claims on other sectors of the domestic economy (annual growth as % of broad money)" ]
Search Response
The search response is a list a list of results, each result is a match on a Dataflow and a list of Components that matched with the match text, and the number of series that exist for the matched term
Example: /ws/public/datasearch?query=population
{
"time" : 28,
"results" : [
{
"Dataflow": "urn:sdmx:org.sdmx.infomodel.datastructure.Dataflow=WB:WDI_HEALTH(1.0)",
"SeriesCount": 17836,
"Components": {
"SERIES": {
"SH_DYN_AIDS_FE_ZS": {
"Name": "Women's share of population ages 15+ living with HIV (%)",
"SeriesCount": 112,
"Match": "Women's share of population ages 15+ living with HIV (%)"
},
"SH_H2O_SAFE_RU_ZS": {
"Name": "Improved water source, rural (% of rural population with access)",
"SeriesCount": 190,
"Match": "Improved water source, rural (% of rural population with access)"
},
.....
}
}
]
}