Skip to content

Commit be9bffc

Browse files
authored
Merge pull request #54 from WaifuAPI/staging
Added query params for quotes endpoint
2 parents 98207b9 + e4ef17d commit be9bffc

File tree

2 files changed

+29
-25
lines changed

2 files changed

+29
-25
lines changed

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "docs.waifu.it",
3-
"version": "3.1.7",
3+
"version": "3.1.8",
44
"description": "The new and improved documentation for Waifu.it",
55
"scripts": {
66
"dev": "next dev",

pages/rest-api/Texts/Quote/search.mdx

Lines changed: 28 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@ import { Tab, Tabs } from "nextra-theme-docs";
22

33
# Search
44

5-
This endpoint allows you to access and retrieve information about your favorite quotes. To access the `/quote` endpoint, you
5+
This endpoint allows you to access and retrieve information about your favorite quotes. To access the `/quote` endpoint, you
66
will need to provide the proper authentication using the Authorization header.
77

8-
98
## Endpoint Details
9+
1010
The `/quote` endpoint allows you to retrieve information about a specific quote.
1111

1212
- **URL**: `/quote`
@@ -20,7 +20,7 @@ To make requests to the `/quote` endpoint, you must include an `Authorization` h
2020
### Example Authorization Header
2121

2222
```jsx
23-
Authorization: YOUR_ACCESS_TOKEN
23+
Authorization: YOUR_ACCESS_TOKEN;
2424
```
2525

2626
Replace `YOUR_ACCESS_TOKEN` with the actual token provided to you.
@@ -29,11 +29,21 @@ Replace `YOUR_ACCESS_TOKEN` with the actual token provided to you.
2929

3030
The request to the `/quote` endpoint should be a JSON object with the following headers:
3131

32-
| Header | Type | Description | Required |
33-
| --------------- | ------- | ---------------------------------------------------- | -------- |
34-
| `Authorization` | string | The unique identifier of the user sending the request. | True |
32+
| Header | Type | Description | Required |
33+
| --------------- | ------ | ------------------------------------------------------ | -------- |
34+
| `Authorization` | string | The unique identifier of the user sending the request. | True |
35+
36+
### Parameters
37+
38+
The request parameters for the `/quote?{parameter}={value}` endpoint.
39+
40+
| Parameter | Type | Description | Required |
41+
| ----------- | ------ | ------------------------------------------------------------------------------------------------------- | -------- |
42+
| `character` | string | (Optional) The desired character name for the query. If not provided, a random quote will be generated. | False |
43+
| `anime` | string | (Optional) The desired anime name for the query. If not provided, a random quote will be selected. | False |
3544

3645
### Example Request
46+
3747
Here's example of how to make a request to the `/quote` endpoint.
3848

3949
<Tabs items={["JavaScript", "Python"]}>
@@ -58,6 +68,7 @@ Here's example of how to make a request to the `/quote` endpoint.
5868

5969
console.log(data);
6070
```
71+
6172
</Tab>
6273
<Tab>
6374
```python
@@ -74,14 +85,15 @@ Here's example of how to make a request to the `/quote` endpoint.
7485

7586
print(data)
7687
```
88+
7789
</Tab>
7890
</Tabs>
7991

8092
Remember to replace `YOUR_ACCESS_TOKEN` with your actual access token.
8193

8294
## Responses
8395

84-
The server will respond with an appropriate message based on the input provided. A successfully API request will respond
96+
The server will respond with an appropriate message based on the input provided. A successfully API request will respond
8597
with a JSON object containing the following information:
8698

8799
- `_id`: The unique identifier of the quote.
@@ -92,29 +104,21 @@ with a JSON object containing the following information:
92104

93105
<Tabs items={["200 OK", "404 Not Found", "500 Internal Server Error"]}>
94106
<Tab>
95-
**Content Type:** `application/json`
96-
```json copy=false
97-
"_id": 88,
98-
"quote": "I don't know everything. I just know what I know.",
99-
"from": "Nisemonogatari",
100-
"author": "Tsubasa Hanekawa"
101-
```
107+
**Content Type:** `application/json` ```json copy=false "_id": 88, "quote":
108+
"I don't know everything. I just know what I know.", "from":
109+
"Nisemonogatari", "author": "Tsubasa Hanekawa" ```
102110
</Tab>
103111
<Tab>
104-
**Content Type:** `application/json`
105-
```json copy=false
106-
"status": 404,
107-
"message": {}
112+
**Content Type:** `application/json` ```json copy=false "status": 404,
113+
"message": {}
108114
```
109115
</Tab>
110116
<Tab>
111-
**Content Type:** `application/json`
112-
```json copy=false
113-
"status": 500,
114-
"message": {}
117+
**Content Type:** `application/json` ```json copy=false "status": 500,
118+
"message": {}
115119
```
116120
</Tab>
117121
</Tabs>
118122

119-
This documentation should help you use [`axios`](https://www.npmjs.com/package/axios) for Node.js and [`requests`](https://pypi.org/project/requests/)
120-
for Python to interact with the `/quote` endpoint.
123+
This documentation should help you use [`axios`](https://www.npmjs.com/package/axios) for Node.js and [`requests`](https://pypi.org/project/requests/)
124+
for Python to interact with the `/quote` endpoint.

0 commit comments

Comments
 (0)