Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/iamtraction/node-trivia-api

❔ A nodejs module for getting trivia questions in all your fancy projects, in a pretty simple way.
https://github.com/iamtraction/node-trivia-api

api-wrapper nodejs npm npm-module npm-package trivia trivia-api

Last synced: about 18 hours ago
JSON representation

❔ A nodejs module for getting trivia questions in all your fancy projects, in a pretty simple way.

Awesome Lists containing this project

README

        

# Trivia API

[![NPM Version](https://img.shields.io/npm/v/trivia-api.svg?style=flat)](https://www.npmjs.com/package/trivia-api)
[![NPM Downloads](https://img.shields.io/npm/dt/trivia-api.svg?style=flat)](https://www.npmjs.com/package/trivia-api)
[![Dependencies](https://david-dm.org/k3rn31p4nic/node-trivia-api.svg)](https://david-dm.org/k3rn31p4nic/node-trivia-api)
[![Known Vulnerabilities](https://snyk.io/test/github/k3rn31p4nic/node-trivia-api/badge.svg)](https://snyk.io/test/github/k3rn31p4nic/node-trivia-api)
[![license](https://img.shields.io/github/license/k3rn31p4nic/node-trivia-api.svg)](LICENSE)
[![PayPal](https://img.shields.io/badge/donate-PayPal-003086.svg)](https://paypal.me/snkrsnkampa)
[![Say Thanks!](https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg)](https://saythanks.io/to/k3rn31p4nic)

A Node.JS module for getting trivia questions in all your fancy projects, in a pretty simple way.

## Classes


Trivia


## Functions



getCategories()Promise.<Object>


Returs the available categories of the trivia questions.




getQuestions([options])Promise.<Object>


Returs a trivia question from the given options.



## Trivia
**Kind**: global class

### new Trivia([options])

| Param | Type | Optional | Description |
| --- | --- | --- | --- |
| [options] | Object | True | The options for Trivia API |
| [options.encoding] | String | True | The encoding format of the result, either `urlLegacy`, `url3986` and `base64`. |

**Example**
```js
const Trivia = require('trivia-api')
const trivia = new Trivia({ encoding: 'url3986' });
```

## getCategories() ⇒ Promise.<Object>
Returs the available categories of the trivia questions.

**Kind**: global function
**Returns**: Promise.<Object> - Resolves available trivia categories and their IDs
**Example**
```js
trivia.getCategories()
.then(console.log)
.catch(console.error);
```

## getQuestions([options]) ⇒ Promise.<Object>
Returs a trivia question from the given options.

**Kind**: global function
**Returns**: Promise.<Object> - Resolves available trivia questions

| Param | Type | Optional | Default | Description |
| --- | --- | --- | --- | --- |
| [options] | Object | True | | The options for retrieving the question |
| [options.amount] | String | True | 1 | The amount of question(s) to be retrieved |
| [options.difficulty] | String | True | | The difficulty of question(s) to be retrieved, either `easy`, `medium` or `hard` |
| [options.category] | Number | True | | The category ID from which the question(s) should be retrieved |
| [options.type] | String | True | | The type of question(s) to be retrieved, either `multiple` or `boolean` |

**Example**
```js
let options = {
type: 'boolean',
amount: 10,
difficulty: 'hard'
};
trivia.getQuestions(options)
.then(questions => console.log(questions))
.catch(console.error);
```

> If you liked this project you can **⭐ Star** it on
> [GitHub](https://github.com/k3rn31p4nic/node-trivia-api) and/or
> [send a thank you note to me](https://saythanks.io/to/k3rn31p4nic).