https://github.com/Thiru-kumaran-R/Riddles-API

RIDDLES API

<div style={{ textAlign: 'center' }}>
  <a href="https://github.com/Thiru-kumaran-R/Riddles-API" style={{ color: 'darkBlue', letterSpacing : "0.2rem" , textDecoration: "none"}} > GITHUB </a>
</div>

### Logic Riddles
Test your problem-solving skills with a variety of logic riddles. These puzzles require sharp thinking and often have surprising solutions that will make you go, "Aha!"

### Funny Riddles
Enjoy a good chuckle with our collection of funny riddles. These light-hearted puzzles are perfect for breaking the ice and adding a bit of humor to your day.

### Mystery Riddles
Dive into the world of intrigue with our mystery riddles. These puzzles will challenge your detective skills, asking you to unravel stories and solve the unsolvable.

### Science-Based Riddles
Engage your curiosity and expand your knowledge with riddles rooted in scientific concepts. Perfect for those who love to learn while having fun, these riddles cover various fields of science including physics, biology, and chemistry.

### Math Riddles
Challenge your numerical skills with riddles that involve mathematics. These puzzles range from simple arithmetic to complex problem-solving.

### Who Am I? Riddles
Test your deductive reasoning with riddles that describe a person, place, or thing. These riddles provide clues that lead to the answer, making you guess "Who am I?"

Go back [home](/).


Welcome to the Riddles API – your ultimate gateway to a world of brain-teasing fun! Our API offers a diverse collection of riddles designed to entertain, educate, and challenge users of all ages. Whether you're a logic puzzle enthusiast, a science nerd, a mystery lover, or someone who enjoys a good laugh, the Riddles API has something for everyone.

Riddles API


### ROUTES :

#### Description : 
GET/category, Retrieve a single riddle with riddle , answer and category as key and it's corresponding as values.

#### Parameters :
category : Filter riddles by category. Available categories are logic, funny, mystery, science, math, who-am-i.

### USAGE  : 
#### Get riddle based on science

```bash
https://riddles-api-eight.vercel.app/science
```
#### Get riddle based on math
```bash
https://riddles-api-eight.vercel.app/math
```

#### Get riddle based on mystery
```bash
https://riddles-api-eight.vercel.app/mystery
```

#### Get funny riddle
```bash
https://riddles-api-eight.vercel.app/funny
```

#### Get riddle based on logics
```bash
https://riddles-api-eight.vercel.app/logic
```
Go back [home](/).

Perfect for developers looking to integrate a wide variety of riddles into their applications, our API offers a rich collection spanning multiple categories, ensuring that there's something for everyone.

GET Riddles

### ROUTES :

#### Description : 
*POST/category(logic, funny, math, who-am-i, mystery, science)*. Add a new riddle to our database. You can specify the category of the riddle to ensure it is appropriately categorized.

#### Request Body Parameters :
`riddles`: The text of the riddle.  
`answer`: The solution to the riddle.   
`category` : The category of the riddle. Must be one of logic, math, funny, mystery, whoami, science.

### USAGE : 
```bash
POST/logic
Content-Type: application/json

{
  "question": "What has keys but can't open locks?",
  "answer": "A piano",
  "category": "logic",
}

```

Go back [home](/).

Enhance the riddle collection in your application by contributing your own puzzles! Our Riddles API allows you to post new riddles across various categories, ensuring a diverse and ever-growing repository.

POST Riddles

#### Validation Error : 
This error might occurs, when a request is malformed -- usually because a field has not been given the correct value type, or the JSON is misformatted. .

**Example**

```bash
{
"message": "riddle field is required",
"status": 422
}
```

#### Routes Error : 
This error might occurs, by reaching wrong route.

**Example**

```bash
{
"message": "No such route exits",
"status": 404
}
```

#### Server Error : 
This error might occurs, when an unexpected server error occurred.

**Example**

```bash
{
"message": "Internal server error",
"status": 500
}
```

Go back [home](/).

When interacting with the Riddles API, error handling is crucial to ensure that your application can gracefully manage issues that arise. Here are examples of error handling responses for both posting and getting data from the API