...
- "json": Javascript Object Notation
- "xml": XML
- "html": HTML
- "csv": Comma-Separated Values
- "chart": Data chart (as image)
- "img": Frame image data
- "sos": SOS format
- "rdf": RDF/XML
- "n3": RDF Notation 3 ("N3")
- "rss": RSS 2.0
- "zip": ZIP archive of requested data
...
Code Block |
---|
/window/start/first/end/last/format/html/uri/urn:streams/snorb7/twitter
|
Here's an equivalent call:
Code Block |
---|
/window/start/first/end/last/format/html/uri/urn%3Astreams%2Fsnorb7%2Ftwitter
|
Supported endpoints
List
List streams. Returns the URIs of all (or selected) streams. For HTML format, returns a list with human-readable names for each stream, which are hyperlinked to calls against the "window" endpoint.
...
- format - desired result format (supported: html, xml, json)
- site (optional) - list only the streams at the given "site" (value should be the URI of a site). A site is any arbitrary grouping of streams. Some fetchers associate multiple streams with a single site.
Example:
Code Block |
---|
/list/format/xml
|
Window
Return all frames (optionally, with data) from a given stream within a given time range. The time range is specified with the start and end parameters. The values of these parameters are either timestamps represented as ms since the *nix epoch, or one of several other notations:
- start can be specified as "first", which means the earliest frame in the stream
- end can be specified as "last", which means the most recent frame in the stream
- either range bound can be specified as "Fn" where n is the number of frames worth of data to fetch relative to the other bound. For example /window/start/F2/end/last... means to return the last two frames of the stream, and /window/start/1298397372/end/F10... means to return the 10 frames following Tue 22 Feb 2011 11:56:12 AM CST.
Parameters:
- start - start time
- end - end time
- format - format (supported: html, xml, json, csv, chart, img, sos, rdf, rss, zip)
- data (optional) - set to "true" to return the data of each frame (may produce very large result)
- sample (optional; if included "data" must be set to "true") - set this to n and the restlet will return every nth frame
- uri - the URI of the stream
Example:
Code Block |
---|
/window/start/1297791028800/end/last/format/xml/data/true/uri/http%3A%2F%2Fiacat-enviro.ncsa.illinois.edu%2FEBIWeatherStations%2FNE%2FAvg15%23PAR_APOGE_Avg |
Example output:
Code Block | ||||
---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?><streams> <stream> <streamURL>http://iacat-enviro.ncsa.illinois.edu/EBIWeatherStations/NE/Avg15#PAR_APOGE_Avg</streamURL> <frames> <frame> <time>1297791900000</time> <dateTime>Tue Feb 15 11:45:00 CST 2011</dateTime> <data>1157</data> </frame> <frame> <time>1297792800000</time> <dateTime>Tue Feb 15 12:00:00 CST 2011</dateTime> <data>1020</data> </frame> </frames> </stream> </streams> |
When data is set to true, the format and encoding of the contents of the data field will depend on the MIME type associated with the stream. If the stream's major MIME type is "text", the data field will contain unicode text; for binary MIME types, the data field will be Base64-encoded. MIME types are associated with streams in the fetching stage, via a filter called TypeRegisterFilter.
Frame
Return a single frame of data from a stream. Note that the MIME type of the response is determined by the stream. If each frame is plain text, it will be set to text/plain; if each stream is a TIFF image, it will be set to image/tiff, etc.
...
- time - the timestamp of the desired frame (in ms since the *nix epoch)
- uri - the URI of the stream
Depending on the server configuration, this endpoint may require authentication.
Example:
Code Block |
---|
/frame/time/1278614700000/uri/http://iacat-enviro.ncsa.illinois.edu/EBIWeatherStations/SE/Avg15%23WindSpd_Max
|
Range
Return the temporal range of the stream (i.e., the time of the earliest frame and the time of the most recent frame).
Parameters:
- format - format (supported: json, xml)
- uri - the URI of the stream
Example response:
Code Block |
---|
[
{
"streamURL": "urn:streams/snorb/twitter",
"start" : 1296859710000,
"end" : 1297101208000
}
]
|
Formats
Return the MIME type of the given stream.
Parameters:
- format - format (supported: html, xml, json, csv)
- uri - the URI of the stream
Example output (CSV):
Code Block |
---|
stream,format
http://ncsa.edu/dsapi/twitter/cufire2,text/plain
|
Triples
Return all metadata about the given stream.
Parameters:
- format - format (supported: rdf, n3)
- uri - the URI of the stream
Example output (rdf):
Code Block | ||||
---|---|---|---|---|
| ||||
<rdf:RDF>
<a:DataStream rdf:about="http://ncsa.edu/dsapi/twitter/cufire2">
<a:characterEncoding>UTF-8</a:characterEncoding>
<dc:format>text/plain</dc:format>
<dc:title>Twitter search for fire near CU</dc:title>
<rdfs:label>Twitter search for fire near CU</rdfs:label>
</a:DataStream>
</rdf:RDF>
|