ASE's Quiz API

This API contains questions for your apps. For now, there are 500+ questions, and the number will increase day by day. The questions consist of 8 different categories and 3 difficulties. Hope this API can be helpful for your apps or games.

If you wanna use this : https://rapidapi.com/AhmedSemih/api/ases-quiz-api1

Overview

• How to use
• Endpoints
  • Questions ("/questions")
  • Categories ("/categories")
  • Difficulties ("/difficulties")
• Data Models
  • Question
  • Category
  • Difficulty

How to use

API is very easy to use and simplified as much as possible for usability and understandability. All response are return this schema : { "data": array (or error), "result_code" : string, "result_message" : string } . All requested data in the "data" field. You can use the "result_message" for checking status. It only can be "success" or "failed".

Endpoints

All endpoints must be preceded by the base url.

Questions ("/questions")

This returns all existing questions.

{
"quesions": [
{
"_id":"633b1f58e9cc1b3541dd07b6",
"text":"What insect can also be known as the Devil`s Darning Needle?""options":
[
{ "option":"Mosquito", "isCorrect":false },
{ "option":"Dragonfly", "isCorrect":true },
{ "option":"Thrips", "isCorrect":false },
{ "option":"Cat Flea", "isCorrect":false },
],
"category":{
"_id":"63357b0d3ab81af9ad154eba",
"name":"Science and Nature"
},
"difficulty":{
"_id":"63357b533ab81af9ad154ebe",
"degree":"Medium"
}
},
"..."
],
"result_code": "200",
"result_message": "success"
}

Get Question By Id ("/questions/:id")

This returns question by id.

Example: ("/questions/633b1f58e9cc1b3541dd07b6");

{
"question": [
{
"_id":"633b1f58e9cc1b3541dd07b6",
"text":"What insect can also be known as the Devil`s Darning Needle?""options":
[
{ "option":"Mosquito", "isCorrect":false },
{ "option":"Dragonfly", "isCorrect":true },
{ "option":"Thrips", "isCorrect":false },
{ "option":"Cat Flea", "isCorrect":false },
],
"category":{
"_id":"63357b0d3ab81af9ad154eba",
"name":"Science and Nature"
},
"difficulty":{
"_id":"63357b533ab81af9ad154ebe",
"degree":"Medium"
}
}
],
"result_code": "200",
"result_message": "success"
}

Get Random Questions ("/questions/:number")

This returns random different questions. Number parameter only can be 20, 50 or 100.

Example: ("/questions/random/20");

{
"questions": [
{
"_id":"633f452a6c9ef451f3102f1f",
"text":"How many times are the words `Hey Jude` mentioned in the Beatles song of the same name?""options":
[
{ "option":"24", "isCorrect":true },
{ "option":"14", "isCorrect":false },
{ "option":"34", "isCorrect":false },
{ "option":"54", "isCorrect":false },
],
"category":{
"_id":"63357ae03ab81af9ad154eb6",
"name":"Music"
},
"difficulty":{
"_id":"63357b5b3ab81af9ad154ec0",
"degree":"Hard"
}
},
"..."
],
"result_code": "200",
"result_message": "success"
}

Get Random 20 Questions By Category ("/questions/random/category/:categoryId")

This returns random 20 different questions in the selected category.

Example: ("/questions/random/category/63357ae03ab81af9ad154eb6");

{
"questions": [
{
"_id":"6340477dd25ee1a315c627ee",
"text":"Who sang the title track for the Bond Film `For Your Eyes Only`?""options":
[
{ "option":"Stevie Nicks", "isCorrect":false },
{ "option":"Mariah Carey", "isCorrect":false },
{ "option":"Whitney Houston", "isCorrect":false },
{ "option":"Sheena Easton", "isCorrect":true },
],
"category":{
"_id":"63357ae03ab81af9ad154eb6",
"name":"Music"
},
"difficulty":{
"_id":"63343ba898b44503fecc49e9",
"degree":"Easy"
}
},
"..."
],
"result_code": "200",
"result_message": "success"
}

Get Random 20 Questions By Difficulty ("questions/random/difficulty/:difficultyId")

This returns random 20 different questions in the the selected category.

Example: ("/questions/random/difficulty/63357b5b3ab81af9ad154ec0");

{
"questions": [
{
"_id":"63404c6b6e7ec86f693e49cc",
"text":"Which country did Bruce Grobbellar represent at football?""options":
[
{ "option":"Sudan", "isCorrect":false },
{ "option":"Congo", "isCorrect":false },
{ "option":"Gabon", "isCorrect":false },
{ "option":"Zimbabwe", "isCorrect":true },
],
"category":{
"_id":"63357a4ec37e5b79f7f18979",
"name":"Sport"
},
"difficulty":{
"_id":"63357b5b3ab81af9ad154ec0",
"degree":"Hard"
}
},
"..."
],
"result_code": "200",
"result_message": "success"
}

Get All Question By Selected Category ("/questions/category/:categoryId")

This returns all questions in the selected category. Questions returns in random order.

Example: ("/questions/category/63357ae03ab81af9ad154eb6");

{
"questions": [
{
"_id":"6340477dd25ee1a315c627ee",
"text":"Who sang the title track for the Bond Film `For Your Eyes Only`?""options":
[
{ "option":"Stevie Nicks", "isCorrect":false },
{ "option":"Mariah Carey", "isCorrect":false },
{ "option":"Whitney Houston", "isCorrect":false },
{ "option":"Sheena Easton", "isCorrect":true },
],
"category":{
"_id":"63357ae03ab81af9ad154eb6",
"name":"Music"
},
"difficulty":{
"_id":"63343ba898b44503fecc49e9",
"degree":"Easy"
}
},
"..."
],
"result_code": "200",
"result_message": "success"
}

Get All Questions By Selected Difficulty ("/questions/difficulty/:difficultyId")

This returns all questions in the selected difficulty. Questions returns in random order.

Example: ("/questions/difficulty/63357b5b3ab81af9ad154ec0");

{
"questions": [
{
"_id":"633963a15717012bd65144ed",
"text":"In which African country is Mount Kilimanjaro?""options":
[
{ "option":"Algeria", "isCorrect":false },
{ "option":"Niger", "isCorrect":false },
{ "option":"Ethiopia", "isCorrect":false },
{ "option":"Tanzania", "isCorrect":true },
],
"category":{
"_id":"63357abb3ab81af9ad154eb0",
"name":"Geography"
},
"difficulty":{
"_id":"63357b5b3ab81af9ad154ec0",
"degree":"Hard"
}
},
"..."
],
"result_code": "200",
"result_message": "success"
}

Categories ("/categories")

This returns all categories.

{
"categories": [
{
"_id": "63357a4ec37e5b79f7f18979",
"name": "Sport"
},
{
"_id": "63357aa53ab81af9ad154eae",
"name": "Art and Literature"
},
{
"_id": "63357abb3ab81af9ad154eb0",
"name": "Geography"
},
{
"_id": "63357ad03ab81af9ad154eb2",
"name": "General Knowledge"
},
{
"_id": "63357adc3ab81af9ad154eb4",
"name": "History"
},
{
"_id": "63357ae03ab81af9ad154eb6",
"name": "Music"
},
{
"_id": "63357af83ab81af9ad154eb8",
"name": "TV Series and Films"
},
{
"_id": "63357b0d3ab81af9ad154eba",
"name": "Science and Nature"
}
],
"result_code": "200",
"result_message": "success"
}

Get Category By Id ("categories/:id")

This returns category by id.

Example: ("categories/63357ad03ab81af9ad154eb2");

{
"category": [
{
"_id": "63357ad03ab81af9ad154eb2",
"name": "General Knowledge"
}
],
"result_code": "200",
"result_message": "success"
}

Difficulties ("/difficulties")

This returns all difficulties.

{
"difficulties": [
{
"_id": "63343ba898b44503fecc49e9",
"degree": "Easy"
},
{
"_id": "63357b533ab81af9ad154ebe",
"degree": "Medium"
},
{
"_id": "63357b5b3ab81af9ad154ec0",
"degree": "Hard"
}
],
"result_code": "200",
"result_message": "success"
}

Get Difficulty By Id ("/difficulties/:id")

This returns difficulty by id.

Example: ("difficulties/63357b533ab81af9ad154ebe")

{
"difficulty": [
{
"_id": "63357b533ab81af9ad154ebe",
"degree": "Medium"
}
],
"result_code": "200",
"result_message": "success"
}

Data Models

Question

Field	Type	Description
_id	string (ObjectId)	Question Id
text	string	Question Text
options	array	Four Options
category	string (ObjectId)	Category Id
difficulty	string (ObjectId)	Difficulty Id

Category

Field	Type	Description
_id	string (ObjectId)	Category Id
name	string	Category Name

Difficulty

Field	Type	Description
_id	string (ObjectId)	Difficulty Id
degree	string	Degree of Difficulty