Skip to content

primeTanM/Excuser

Repository files navigation

ExcuserAPI

Creates different excuses related to various situations. It is free to use without any API key. Visit https://excuser-three.vercel.app/ for more instructions.

Maintainers

  1. Tanmay Misra
  2. Kaustubh Dwivedi

Examples


Family: My best friend got in an accident and I had to take his place.

Office: My parents showed up unannounced at my house.

Children: My temperature is really high today.

College: As my parents were not home so I went to drop off my little brother at school.

Party: I went too hard at my friend's party last night. Too tired right now. I'm going to have to sit this one out.

Usage


Enter these commands into a shell.

All commands accept a optional param on header to change execuses language.

Language header language value
English eng
Brazilian Portuguese pt-br
Bengali ben
French fren
Hindi hin
Turkish tr

Get a random excuse

curl https://excuser-three.vercel.app/v1/excuse \
--header 'language: eng' # Optinal Param | Default language is eng (english)

Get a specific excuse with a specific id

curl https://excuser-three.vercel.app/v1/excuse/id/101 \
--header 'language: eng' # Optinal Param | Default language is eng (english)

Get n random excuses

curl https://excuser-three.vercel.app/v1/excuse/3 \
--header 'language: eng' # Optinal Param | Default language is eng (english)

Get a random excuse from a specific category

curl https://excuser-three.vercel.app/v1/excuse/office \
--header 'language: eng' # Optinal Param | Default language is eng (english)

Get n random excuses from a specific category

curl https://excuser-three.vercel.app/v1/excuse/college/4 \
--header 'language: eng' # Optinal Param | Default language is eng (english)

Contribute


  1. Have minimum 10 excuses at least then open a PR. If you want a new category, then minimum 20 excuses.
  2. Look through the existing excuses inside Excuses_eng.js or Excuses_pt_br.js to see if your excuse is original.
  3. Go to the Issues tab at the top of the GitHub page.
  4. Create a New Issue.
  5. Contribute your excuses using the format below.
id: 
excuse:
category:

Deployed APP


Checkout this webapp made by Harshp20 using Excuser API, feel free to contribute to it or make one yourself. 😉

Deployed app: https://harshp20.github.io/Excuse-Maker

Repository: https://github.com/Harshp20/Excuse-Maker