Awesome

meowfacts

Description:

A simple api that returns a random fact about cats on a GET request

Example Usage

curl https://meowfacts.herokuapp.com/

Response

{
  "data": [
    "0": 	"Mother cats teach their kittens to use the litter box."
  ]
}

Advanced Usage

You can request more than one fact at a time by using the GET param count

curl https://meowfacts.herokuapp.com/?count=3

Response

{
  "data": [
    "0": 	"Mother cats teach their kittens to use the litter box.",
    "1": "A cat can sprint at about thirty-one miles per hour.",
    "2": "The worlds richest cat is worth $13 million after his human passed away and left her fortune to him."
  ]
}

You can request a specific fact if you know the ID / order it is buy passing the GET param id

curl https://meowfacts.herokuapp.com/?id=3

Response

{
  "data": [
    "0": 	"Mother cats teach their kittens to use the litter box."
  ]
}

Language Support

You can request the response in different languages by using the GET param lang

curl https://meowfacts.herokuapp.com/?lang=ukr

Response

{
  "data": [
    "0": 	"Найбагатший у світі кіт коштує 13 мільйонів доларів після того, як його людина померла і залишила йому свій стан"
  ]
}

Supported Languages

The supported languages are listed below, you can use any of the lang Values in the first column as a lang param.

"?lang=esp" and "?lang=esp-mx" will both return spanish for your response, and simply using the ISO-639-1 code will default to esp-mx for simplicity.

Documentation

Local Development

Installation

npm install

Basic usage

npm run start

Dedication && Funding