PolyDataVault

"Various data for various use cases."

Data Preview

Server

https://pdv.ourspace.ch

Endpoints

colors

Randomly generated colors.

random  GET  /api/collections/random_color/records/1

leet

Leet characters.

random  GET  /api/collections/random_leet/records/1
list    GET  /api/collections/leet/records
view    GET  /api/collections/leet/records/{id}

numbers

Randomly generated numbers.

random  GET  /api/collections/random_number/records/1

quotes

Words from people - mostly about art and life.

random  GET  /api/collections/random_quote/records/1
list    GET  /api/collections/quotes/records
view    GET  /api/collections/quotes/records/{id}

s9tracks

Music tracks meta data from spartalien.com.

random  GET  /api/collections/random_s9track/records/1
list    GET  /api/collections/s9tracks/records
view    GET  /api/collections/s9tracks/records/{id}

skyrecorder

Timelapse video meta data from sky.etrusci.org.

random  GET  /api/collections/random_skyrecorder/records/1
list    GET  /api/collections/skyrecorder/records
view    GET  /api/collections/skyrecorder/records/{id}

webradios

Cool webradios I like.

random  GET  /api/collections/random_webradio/records/1
list    GET  /api/collections/webradios/records
view    GET  /api/collections/webradios/records/{id}
file    GET  /webradios.m3u

Request Parameters

(q) = in query
(p) = in path
(h) = in header
 *  = required
 |  = or

random

(q)    fields (string)

list

(h|q)  * pdv_api_key (string)
(q)    page (integer)
(q)    perPage (integer)
(q)    sort (string)
(q)    filter (string)
(q)    fields (string)
(q)    skipTotal (boolean)

view

(h|q)  * pdv_api_key (string)
(p)    * id (string)
(q)    fields (string)
(q)    digits (integer, only applies to 'numbers' endpoint requests)

file

none

Authentication

For the random and file endpoints no authentication is needed currently.
The list and view endpoints need authentication in form of an API key. You can either provide it in the request header or query string. If no key is provided for these endpoints, the request will not fail but the result list will be empty.
Currently keys are given out only to friends, but this may change in the near future. So... just send me a message you want a personal API key 👽

Rate Limit

All /api/* requests: 30 requests per 10 seconds

Example Requests

random

curl https://pdv.ourspace.ch/api/collections/random_color/records/1
curl https://pdv.ourspace.ch/api/collections/random_quote/records/1
curl https://pdv.ourspace.ch/api/collections/random_quote/records/1?fields=author,quote

list

curl https://pdv.ourspace.ch/api/collections/colors/records --header 'pdv_api_key: YOUR_PRIVATE_KEY'
curl https://pdv.ourspace.ch/api/collections/quotes/records?pdv_api_key=YOUR_PRIVATE_KEY
curl https://pdv.ourspace.ch/api/collections/quotes/records?pdv_api_key=YOUR_PRIVATE_KEY&fields=author,quote

view

curl https://pdv.ourspace.ch/api/collections/colors/records/r1234a567b89c101 --header 'pdv_api_key: YOUR_PRIVATE_KEY'
curl https://pdv.ourspace.ch/api/collections/quotes/records/r4321d765e98f010?pdv_api_key=YOUR_PRIVATE_KEY
curl https://pdv.ourspace.ch/api/collections/quotes/records/r4321d765e98f010?pdv_api_key=YOUR_PRIVATE_KEY&fields=author,quote

file

curl https://pdv.ourspace.ch/webradios.m3u