Routes

# v.1

#

GET

/v1/quotes
Param name Description Values Default
rand Random quotes? True values: t, true, 1. Anything else is false. t
n # of quotes 0, 1, ..., max 1
offset 0, 1, ... 0
author Strings like pearce
tags Comma-separated tags like technology,ethics
tmode tag mode: Match all (default) of the supplied tags or at least one? I.e. match conjunctively (AND, all) or disjunctively (OR, any)? any, all all
lang Two-letter ISO 639-1 code like fi en
Example response from /v1/quotes?rand=t&n=2&author=pearce&tags=future,transhumanism (formatted):

          {
            "quotes": [{
              "tags": ["ethics", "evolution", "transhumanism", "future", "paradise engineering", "humans"],
              "quote": "Too many of our preferences reflect nasty behaviours and states of mind that were genetically adaptive in the ancestral environment. Instead, wouldn't it be better if we rewrote our own corrupt code?",
              "lang": "en",
              "author": "David Pearce"
            }, {
              "tags": ["science", "transhumanism", "future", "altruism", "paradise engineering"],
              "quote": "[T]rue hedonic engineering, as distinct from mindless hedonism or reckless personal experimentation, can be profoundly good for our character. Character-building technologies can benefit utilitarians and non-utilitarians alike. Potentially, we can use a convergence of biotech, nanorobotics and information technology to gain control over our emotions and become better (post-)human beings, to cultivate the virtues, strength of character, decency, to become kinder, friendlier, more compassionate: to become the type of (post)human beings that we might aspire to be, but aren't, and biologically couldn't be, with the neural machinery of unenriched minds. Given our Darwinian biology, too many forms of admirable behaviour simply aren't rewarding enough for us to practise them consistently: our second-order desires to live better lives as better people are often feeble echoes of our baser passions.",
              "lang": "en",
              "author": "David Pearce"
            }]
          }
        
#

GET

/v1/meta
Param name Description Values Default
ks fields to return Comma-separated keys like n_quotes,max_quotes n_quotes
Example response from /v1/meta?ks=n_quotes,max_quotes (formatted, comments added):

          {
            "n_quotes":159, // the number of quotes in the database
            "max_quotes":50 // the maximum number of quotes that can be returned at once
          }