Welcome to the cowsay HTTP API!

GET /api -- This page (you are here)

GET /api/cowsay -- Does 'fortune | cowsay' by default (customize with URL parameters)

  URL PARAMS
    say                 string  // Thing to say (defaults to fortune command)
    cowfile,cow,cf      string  // Specify a cowfile (add listCows param to list available cowfiles)
    randomCow,random,r  bool    // Pick a random cowfile
    listCows,list       bool    // List all cowfiles available
    allCows,all					bool    // Get message with all cowfiles available

    // Additional cows flags
    b bool  // Cow appears borg mode
    d bool  // Cow appears dead
    g bool  // Cow appears greedy
    p bool  // Cow appears paranoia
    s bool  // Cow appears st0ned
    t bool  // Cow appears tired
    w bool  // Cow appears wired (not tired)
    y bool  // Cow appears youthful

ALIASES for /api/cowsay path:
  /api/say
  /api/cow
  /api/cs

---

EXAMPLES:
  # random fortune + cowsay (classic)
  cows.rest/api/cowsay
  cows.rest/api/cs

  # random fortune + random cow
  cows.rest/api/cowsay?random
  cows.rest/api/cs?r

  # using misc query parameters
  cows.rest/api/cowsay?d&say=0xDEADBEEF
  cows.rest/api/cs?d&say=0xDEADBEEF
  cows.rest/api/cow?say=moo%20world

  # get all cows
  cows.rest/api/cs?all

TIP:
  # URL escape strings with perl or python:
  perl -nE 'use URI::Escape; chomp $_; print(uri_escape($_))' <<< "some long random text"
  python -c 'import urllib.parse; print(urllib.parse.quote(input()))' <<< "some long random text"

  curl "cows.rest/api/cowsay?random&say=some+long+random+text"

GITHUB:
https://github.com/lemonase/cowsay-http