This document describes how to access the metadata DBs in KASI Science Data Archive via HTTP APIs.
...
1. Search by coordinates (RA & DEC)
- HTTP GET request ( URL: https://data.kasi.re.kr/api/facility/search?key1=value1&key2=value2&... )
- Applicable facilities (case sensitive) : KMTNet, MIRIS,
KVN(not ready yet) - Request parameters : RA, DEC, rad, unit, limit
- Response type : JSON
- Examples :
| Key | Value | Option | Default | Description |
|---|---|---|---|---|
| ra | Double | Right Ascension (J2000) of input coordinates in degrees | ||
| dec | Double | Declination (J2000) of input coordinates in degrees | ||
| rad | Double | 30 | Search radius around the given input coordinates. Result table will be presented by default with increasing distances from the input coordinate. | |
| unit | String | degree arcmin arcsec | arcmin | Unit of search radius |
| limit | Integer | 100 | Limit in number of rows returned |
...
2. Search by publications (DOI)
- HTTP GET request ( URL: https://data.kasi.re.kr/api/publication/doi?DOI=DOI_name )
- Request parameters : DOI
- Response type : JSON (DOI, facility, dataID)
- Examples :
| Key | Value |
|---|
| Description | ||
|---|---|---|
| DOI | String | DOI (Digital Object Identifier) name (i.e., prefix+'/'+suffix, see DOI syntax). Partial string can be matched by regular expression method. |
...
3. List metadata by dataID
- HTTP GET request ( URL: https://data.kasi.re.kr/api/facility/list/dataID dataID1|dataID2|dataID3... )
- Applicable facilities (case sensitive) : KMTNet, MIRIS,
KVN(not ready yet) - Request parameters : dataID(s)
- Multiple dataIDs can be requested with pipe-delimited("|") string array
- Response type : JSON
- Examples :
| Key | Value | Option | Description | |
|---|---|---|---|---|
| dataID | String( | pipe-delimited | )string array for multiple dataIDs | Data identifier |
...
4. Retrieve publication information
- HTTP GET request ( URL: https://data.kasi.re.kr/api/publication/search?key1=value1&key2=value2&... )
- Request parameters : facility, dataID
- Response type : JSON (DOI, facility, dataID)
- Examples :
- External API : https://github.com/adsabs/adsabs-dev-api/blob/master/Search_API.ipynb
- base URL : https://api.adsabs.harvard.edu/v1/search/query?
- queries should include API access token (e.g., curl -H 'Authorization: Bearer <token>' 'https://api.adsabs.harvard.edu/v1/search/query?q=star')
- query parameters : q=doi:DOI_URL-encoded&fl=title,author,bibcode,citation_count,abstract
- Link to the article information (ADS) : https://ui.adsabs.harvard.edu/abs/bibcode
| Key | Value | Option | Default | Description |
|---|---|---|---|---|
| facility | String | KMTNet KVN MIRIS | all | Select one of the data collections |
| dataID | String | Data identifier used in the publication |
...
5. Register your publication
- HTTP POST request (URL: https://data.kasi.re.kr/api/register/request)
- Request parameters : name, email, DOI, facility, dataID, comment
- Response type : JSON document saved to publication DB collection
- Registered information should be verified by administrators before showing up in the API search results.
...