search

wh-iterabb-it / meowfacts

🐈 a simple api which returns a catfact
https://meowfacts.herokuapp.com/
MIT License
409 stars 58 forks source link
api catfacts hacktoberfest js-api-examples learning-by-doing restful-api

readme

meowfacts

Issues License Known Vulnerabilities codecov

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.

LANG Variable ISO 639-1 Language Name Localization (country)
eng-us eng English USA
ces-cz or cze-cz cze (B) ces (T) Czech CZ
ger-de ger German DE
ben-in ben Bengali IN
esp-es esp Spanish ES
esp-mx esp Spanish (default) MX
rus-ru rus Russian RUS
por-br por Portuguese BR
tl-fil fil Filipino PH
ukr-ua ukr Ukrainian UA
urd-ur urd Urdu UR
ita-it ita Italian IT
zho-tw zho Chinese TW (Taiwan)
kor-ko kor Korean KO
Help us expand and improve Internationalization on this API (Click to expand)

Help us expand and improve Internationalization on this API

Note: We are trying to follow the browser's language tags, which are formally defined in RFC 5646, which rely on the ISO 639 standard (quite often the 639-1 code list) for language codes to be used.

We would love it if you helped this project by taking a look at our Call for Contributors to see if you can make a contribution that helps us be more inclusive and support more languages.

Documentation

Local Development

Installation

npm install

Basic usage

npm run start

Dedication && Funding

This api is dedicated to pistachio; she brought me great comfort in dire times. Words can't describe the debt I owe to her.

My cat, Sleeping on her back on a table, she did this everywhere because the fan would cool her belly.

If you enjoy this api, or just love cats, please donate to:

NYC Animal Project Website

NYC Animal Project Paypal Link

NYC Animal Project is a struggling `no kill` cat shelter in the heart of new york that relies entirely on fosters and help from small donations. I can say personally having volunteered for them, even a few cents donation would make a difference for the very small organization. I fostered many kittens from them, and Pistachio was the runt that went un-adopted. She was shy, but very outgoing when she got settled. I highly recommend to foster and adopt if you can.