This document describes how to access the metadata DBs in KASI Science Data Archive via HTTP APIs (https://data.kasi.re.
...
kr/api/).
1. Search by coordinates (RA & DEC)
- HTTP GET request ( URL: https://data.kasi.re.kr/api/data_collectionfacility/search?key1=value1&key2=value2&... )
- Applicable data collections facilities (case sensitive) : KMTNet, KVN, MIRIS,
KVN - Request parameters : RA, DEC, rad, unit, limit, (object, band, project, datatype)
- Response type : JSON (full metadata)
- 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 |
Search results can be narrowed down by additional parameters below :
Key | Value | Option | Description |
---|---|---|---|
object | String | Target name | |
band | String | Observing bandpass (e.g., filter, frequency) | |
project | String | Project/Proposal ID | |
datatype | String | Type of data (e.g., OBJECT, FLAT, ...) |
2. Search by publications (DOI)
- HTTP GET request ( URL: httpshttps://data.kasi.re.kr/api/data_collection/publication?doi=doiname)
Applicable data collections : KMTNet, KVN, MIRIS (case sensitive)/publication/find?DOI=DOI_name) - Request parameters : DOI, facility(optional)
- Response type : JSON (DOI, facility, dataID)
- Examples :
Key | Value | Option | Default | Description |
---|---|---|---|---|
DOI | String | DOI (Digital Object Identifier) name (i.e., prefix+'/'+suffix, see DOI syntax). *Partial string can be matched by regular expression method. | ||
facility | String | KMTNet KVN MIRIS | all | Select one of the data collections |
3. List metadata by dataID
- HTTP GET request ( URL: https://data.kasi.re.kr/api/publication/search?key1=value1&key2=value2&facility/list/dataID1|dataID2|dataID3... )
- Applicable facilities (case sensitive) : KMTNet, KVN, MIRIS
- Request parameters : DOI, facility, dataIDdataID(s)
- Multiple dataIDs can be requested with pipe-delimited("|") string array
- Response type : JSON (full metadata)
- Examples :
- https://data.kasi.re.kr/api/MIRIS/publication?doi=10.1000/xyz123
Key | Value | Option | Description |
---|---|---|---|
dataID | String | pipe-delimited string array for multiple dataIDs (e.g., dataID1|dataID2|dataID3...) | Data identifier |
4. Retrieve publication information
- HTTP GET request ( URL: https://apidata.kasi.altmetricre.comkr/v1api/publication/search?facility=value1&dataID=value2)
- Request parameters : facility, dataID
- Response type : JSON (DOI, facility, dataID)
- Examples :
- https://data.kasi.re.kr/api/publication/search?facility=MIRIS&dataID=MS1421157411doi/DOI)
fetch "title", "journal", "authors", "url"
- https://data.kasi.re.kr/api/publication/search?facility=MIRIS&dataID=MS1421157411doi/DOI)
- 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
Additional link to the article information (ADS) : http://adsabs.harvard.edu/doi/DOI- Link to the article information (ADS) : https://ui.adsabs.harvard.edu/abs/bibcode
Key | Value | Option | Default |
---|
Description |
---|
DOI (Digital Object Identifier) name (i.e., prefix+'/'+suffix, see DOI syntax).
Partial string can be matched by regular expression method.facility | String | KMTNet KVN MIRIS | all | Select one of the data collections |
dataID | String |
Data identifier used in the publication |
Link your publication to our data
Register your publication
...
*Input string must match exactly with dataID in metadata databases. (i.e., partial string match is not allowed) |
5. Register your publication
- HTTP POST request ( URL: https://data.kasi.re.kr/api/register/request )
- Request parameters : JSON body {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.
Key | Value | Option |
---|
Description | |||
---|---|---|---|
name | String | Your name | |
String | E-mail address | ||
DOI | String |
DOI name of the publication to be registered | |||
facility | String | KMTNet KVN MIRIS | Select one of the data collections |
dataID | String Array | List of data identifiers used in the publication | |
comment | String | Message to database managers |
Info |
---|
Document written by chr@kasi.re.kr |
관련 문서
Content by Label | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...