Real-Time Measurements from the Department of Atmospheric Sciences at the University of North Dakota

CHORDS Data URLs

URLs for data ingest and download
Instrument: cdp (id: 23)
Although this example is for a specific instrument, the syntax is common to all of them. instrument_id specifies the instrument. For putting data, there is a list of variable short names with their corresponding measurement value. All of the qualifiers (i.e. the fields following "?" and "") are order independent.

Download Single Instrument Data


Action URL format Qualifiers Example
Insert data w/instrument_id GET instrument_id, at, email, api_key, test http://3.89.34.59/measurements/url_create?instrument_id=23&laser_cur=Cloud Droplet Probe Laser Current [mA]&dump_spot=Cloud Droplet Probe Dump Spot Monitor [v]&wing_temp=Cloud Droplet Probe Wingboard Temperature [C]&laser_temp=Cloud Droplet Probe Laser Temperature [C]&sizer_base=Cloud Droplet Probe Sizer Baseline [#]&qual_base=Cloud Droplet Probe Qualifier Baseline [#]&plus_five=Cloud Droplet Probe Plus Five Volt Monitor [v]&board_temp=Cloud Droplet Probe Control Board Temperature [C]&reject_dof=Cloud Droplet Probe Reject DOF [#]&qual_band =Cloud Droplet Probe Qualifier Bandwidth [#]&qual_thres=Cloud Droplet Probe Qualifier Threshold [#]&avg_tran=Cloud Droplet Probe Average Transit Time [msec]&dt_band=Cloud Droplet Probe DT Bandwidth [#]&dy_thres=Cloud Droplet Probe Dynamic Threshold [#]&adc=Cloud Droplet Probe ADC Overflow [#]&ch01=Cloud Droplet Probe Channel 1 [#]&ch02=Cloud Droplet Probe Channel 2 [#]&ch03=Cloud Droplet Probe Channel 3 [#]&ch04=Cloud Droplet Probe Channel 4 [#]&ch05=Cloud Droplet Probe Channel 5 [#]&ch06=Cloud Droplet Probe Channel 6 [#]&ch07=Cloud Droplet Probe Channel 7 [#]&ch08=Cloud Droplet Probe Channel 8 [#]&ch09=Cloud Droplet Probe Channel 9 [#]&ch10=Cloud Droplet Probe Channel 10 [#]&ch11=Cloud Droplet Probe Channel 11 [#]&ch12=Cloud Droplet Probe Channel 12 [#]&ch13=Cloud Droplet Probe Channel 13 [#]&ch14=Cloud Droplet Probe Channel 14 [#]&ch15=Cloud Droplet Probe Channel 15 [#]&ch16=Cloud Droplet Probe Channel 16 [#]&ch17=Cloud Droplet Probe Channel 17 [#]&ch18=Cloud Droplet Probe Channel 18 [#]&ch19=Cloud Droplet Probe Channel 19 [#]&ch20=Cloud Droplet Probe Channel 20 [#]&ch21=Cloud Droplet Probe Channel 21 [#]&ch22=Cloud Droplet Probe Channel 22 [#]&ch23=Cloud Droplet Probe Channel 23 [#]&ch24=Cloud Droplet Probe Channel 24 [#]&ch25=Cloud Droplet Probe Channel 25 [#]&ch26=Cloud Droplet Probe Channel 26 [#]&ch27=Cloud Droplet Probe Channel 27 [#]&ch28=Cloud Droplet Probe Channel 28 [#]&ch29=Cloud Droplet Probe Channel 29 [#]&ch30=Cloud Droplet Probe Channel 30 [#]&at=2015-08-20T19:50:28&email=[USER_EMAIL]&api_key=[API_KEY]&test
Insert data w/sensor_id GET sensor_id, at, email, api_key, test http://3.89.34.59/measurements/url_create?sensor_id=23&laser_cur=Cloud Droplet Probe Laser Current [mA]&dump_spot=Cloud Droplet Probe Dump Spot Monitor [v]&wing_temp=Cloud Droplet Probe Wingboard Temperature [C]&laser_temp=Cloud Droplet Probe Laser Temperature [C]&sizer_base=Cloud Droplet Probe Sizer Baseline [#]&qual_base=Cloud Droplet Probe Qualifier Baseline [#]&plus_five=Cloud Droplet Probe Plus Five Volt Monitor [v]&board_temp=Cloud Droplet Probe Control Board Temperature [C]&reject_dof=Cloud Droplet Probe Reject DOF [#]&qual_band =Cloud Droplet Probe Qualifier Bandwidth [#]&qual_thres=Cloud Droplet Probe Qualifier Threshold [#]&avg_tran=Cloud Droplet Probe Average Transit Time [msec]&dt_band=Cloud Droplet Probe DT Bandwidth [#]&dy_thres=Cloud Droplet Probe Dynamic Threshold [#]&adc=Cloud Droplet Probe ADC Overflow [#]&ch01=Cloud Droplet Probe Channel 1 [#]&ch02=Cloud Droplet Probe Channel 2 [#]&ch03=Cloud Droplet Probe Channel 3 [#]&ch04=Cloud Droplet Probe Channel 4 [#]&ch05=Cloud Droplet Probe Channel 5 [#]&ch06=Cloud Droplet Probe Channel 6 [#]&ch07=Cloud Droplet Probe Channel 7 [#]&ch08=Cloud Droplet Probe Channel 8 [#]&ch09=Cloud Droplet Probe Channel 9 [#]&ch10=Cloud Droplet Probe Channel 10 [#]&ch11=Cloud Droplet Probe Channel 11 [#]&ch12=Cloud Droplet Probe Channel 12 [#]&ch13=Cloud Droplet Probe Channel 13 [#]&ch14=Cloud Droplet Probe Channel 14 [#]&ch15=Cloud Droplet Probe Channel 15 [#]&ch16=Cloud Droplet Probe Channel 16 [#]&ch17=Cloud Droplet Probe Channel 17 [#]&ch18=Cloud Droplet Probe Channel 18 [#]&ch19=Cloud Droplet Probe Channel 19 [#]&ch20=Cloud Droplet Probe Channel 20 [#]&ch21=Cloud Droplet Probe Channel 21 [#]&ch22=Cloud Droplet Probe Channel 22 [#]&ch23=Cloud Droplet Probe Channel 23 [#]&ch24=Cloud Droplet Probe Channel 24 [#]&ch25=Cloud Droplet Probe Channel 25 [#]&ch26=Cloud Droplet Probe Channel 26 [#]&ch27=Cloud Droplet Probe Channel 27 [#]&ch28=Cloud Droplet Probe Channel 28 [#]&ch29=Cloud Droplet Probe Channel 29 [#]&ch30=Cloud Droplet Probe Channel 30 [#]&at=2015-08-20T19:50:28&email=[USER_EMAIL]&api_key=[API_KEY]&test
Fetch a CSV file .csv start, end, last http://3.89.34.59/api/v1/data/23.csv?start=2015-08-01T00:30&end=2015-08-20T12:30
http://3.89.34.59/api/v1/data/23.csv?last
Fetch a GeoJSON file .geojson start, end, last http://3.89.34.59/api/v1/data/23.geojson
http://3.89.34.59/api/v1/data/23.geojson?start=2015-08-01T00:30&end=2015-08-20T12:30
http://3.89.34.59/api/v1/data/23.geojson?last

Download Multiple Instrument Data


Action URL format Qualifiers Example
Download all instruments for past 24 hours GET http://3.89.34.59/api/v1/data
http://3.89.34.59/api/v1/data.json
http://3.89.34.59/api/v1/data.geojson
Download all instruments for past 24 hours with authentication GET email, api_key http://3.89.34.59/api/v1/data?email=[USER_EMAIL]&api_key=[API_KEY]
Download all instruments w/date range GET start, end http://3.89.34.59/api/v1/data?start=2015-08-01T00:30&end=2015-08-20T12:30
Download all instruments w/date range test data only GET start, end, test http://3.89.34.59/api/v1/data?start=2015-08-01T00:30&end=2015-08-20T12:30&test
Download multiple instruments w/instrument ids GET instruments, start, end http://3.89.34.59/api/v1/data?instruments=1,2,3&start=2015-08-01T00:30&end=2015-08-20T12:30
Download multiple instruments w/sensor ids GET sensors, start, end http://3.89.34.59/api/v1/data?sensors=sen1,sen2,sen3&start=2015-08-01T00:30&end=2015-08-20T12:30

Optional Parameters


Optional
Qualifiers 		Meaning
sensor_id= SENSOR_ID A sensor id may be specified instead of the numerical instrument id, this value superceeds instrument id if both are given
at= time A time to assign to the measurement. If not present, the measurement will be time stamped with the time that it was received by the portal.
api_key= API_KEY An optional validation key. It is required if "Require the security key in order to submit a measurement" is checked in the configuration. The api key value is specified in the user configuration.
email= USER_EMAIL A user email is required when supplying an API Key to access secured data.
test If present, this measurement will be marked as a test value. Test values can be deleted from the database using the "Delete Test Button" on the instrument page. Do not use this option for production-ready instruments.
start= time A start time for the returned measurements.
end= time An end time for the returned measurements.
last Return all measurements for the most recent measurement time stamp.
include_test_data=true Include test data in data downloads.