Add /cached-latest endpoint + minor fixes

Author: Rajdave69

docs/API/Using the API/Use-cachedlatest.md

@@ -0,0 +1,80 @@
+---
+sidebar_position: 4
+---
+
+# Using /cached-latest Endpoint
+
+In this tutorial, we will be using the /cached-latest endpoint to get a cached list of 
+all circulars in one Category.
+
+This endpoint returns a dictionary (for `receive` being `all`) or string (for `receive` being `titles`/`links`), containing the latest circular (of the given category)'s title and direct download URL like the /latest endpoint.
+But, This endpoint caches the latest circular for an hour, and returns the cached circulars if the cache is still valid. 
+
+This endpoint should be used when making an app that needs to get the latest circulars in one Category but does not need minute level precision.
+
+:::warning Warning!
+
+Don't use this endpoint if you're making an app that needs minute level precision. Use `/latest` instead!
+
+:::
+
+#### Parameters:
+* `category` : `string`. Can have values (`general`, `ptm`, `exam`) [Mandatory]
+* `receive` : `string`. Can have values (`all`, `titles`, `links`) [Optional]
+
+The `category` parameter refers to one of the 3 main category of circulars on the 
+BPS Website.
+
+The `receive` parameter refers to what data you want to receive, either `all` which gives
+the latest circular's Name and download URL, or `titles` which gives only the latest circular's Name, or `links` which gives only the latest circular's download URL.
+
+## Example Requests
+
+Python
+
+
+```python
+import requests
+
+url = "https://raj.moonball.io/bpsapi/v1/cached-latest/"
+payload = {'category': 'ptm', "receive": "all"}
+
+request = requests.get(url, json=payload)
+print(request.text)
+```
+
+Curl
+
+```bash
+curl -X 'GET' \
+  'https://raj.moonball.io/bpsapi/v1/cached-latest/' \
+  -H 'accept: application/json' \
+  -H 'Content-Type: application/json' \
+  -d '{
+  "category": "ptm",
+  "receive": "all"
+      }'
+```
+
+## Example Response
+
+1. Category: `ptm`, Receive: `all`
+
+```python
+{"title":"2nd Parent Teacher Meeting (PTM) for Grades IX, X & XII",
+"link":"https://bpsdoha.com/circular/category/40-circular-ptm-2022-23?download=1095:2nd-parent-teacher-meeting-ptm-for-grades-ix-x-xii"}
+```
+
+2. Category: `ptm`, Receive: `titles`
+
+```python
+"2nd Parent Teacher Meeting (PTM) for Grades IX, X & XII"
+```
+
+3. Category: `ptm`, Receive: `links`
+
+```python
+"https://bpsdoha.com/circular/category/40-circular-ptm-2022-23?download=1095:2nd-parent-teacher-meeting-ptm-for-grades-ix-x-xii"
+```
+
+Thanks for reading!

docs/API/Using the API/Use-geturl.md

@@ -3,8 +3,8 @@ sidebar_position: 3
 ---
 # Using /search Endpoint
 
-In this tutorial, we will be using the /search endpoint to get a circular's download URL.
-The /search endpoint returns a string containing the download URL of the circular, taking the circular title as a parameter.
+In this tutorial, we will be using the `/search` endpoint to get a circular's download URL.
+The `/search` endpoint returns a string containing the download URL of the circular, taking the circular title as a parameter.
 
 This endpoint returns a string (or None if not found) containing the download URL of the circular.
 

docs/API/Using the API/Use-latest.md

@@ -4,11 +4,16 @@ sidebar_position: 2
 
 # Using /latest Endpoint
 
-In this tutorial, we will be using the /latest endpoint to get a list of 
-all circulars in one Category.
+In this tutorial, we will be using the /latest endpoint to get the latest
+circular in a category.
 
-This endpoint returns a dictionary (for `receive` being `all`) or string (for `receive` being `titles`/`links`, )containing the latest circular (of the given category)'s title and direct download URL.
+This endpoint returns a dictionary (for `receive` being `all`) or string (for `receive` being `titles`/`links`), containing the latest circular (of the given category)'s title and direct download URL.
 
+:::tip Tip!
+
+Use the `/cached-latest` endpoint if you're making an app that does not require minute level precision. It gives faster responses and reduces server load :D
+
+:::
 
 #### Parameters:
 * `category` : `string`. Can have values (`general`, `ptm`, `exam`) [Mandatory]