stupid-apis/doc/api.md

📄 API Documentation – Stupid APIs

Base URL

http://localhost:3000

---

1️⃣ POST /sort

Sorts an array (numeric or alphabetical) and returns the sorted array.

Request

URL:

POST /sort

Headers:

Content-Type: application/json

Body Example:

{
  "array": [3, 1, 4, 1, 5, 9]
}

Successful Response

{
  "sortedArray": [1, 1, 3, 4, 5, 9]
}

Error Responses

Status Code	Description
400	Request body missing or array is not an array
500	Unexpected server error

---

2️⃣ POST /is-odd

Checks if a given number is odd.

Request

URL:

POST /is-odd

Headers:

Content-Type: application/json

Body Example:

{
  "number": 7
}

Successful Response

{
  "number": 7,
  "isOdd": true
}

Example with an even number:

{
  "number": 4,
  "isOdd": false
}

Error Responses

Status Code	Description
400	Request body missing or number is not a valid number
500	Unexpected server error

---

3️⃣ POST /is-even

Checks if a given number is even.

Request

URL:

POST /is-even

Headers:

Content-Type: application/json

Body Example:

{
  "number": 4
}

Successful Response

{
  "number": 4,
  "isEven": true
}

Example with an odd number:

{
  "number": 7,
  "isEven": false
}

Error Responses

Status Code	Description
400	Request body missing or number is not a valid number
500	Unexpected server error

---

📌 Example Usage with curl

Sort an array (Linux/macOS)

curl -X POST http://localhost:3000/sort \
  -H "Content-Type: application/json" \
  -d '{"array":[3,1,4,1,5,9]}'

Check if odd

curl -X POST http://localhost:3000/is-odd \
  -H "Content-Type: application/json" \
  -d '{"number":7}'

Check if even

curl -X POST http://localhost:3000/is-even \
  -H "Content-Type: application/json" \
  -d '{"number":4}'