# 📄 API Documentation – **Stupid APIs**

## Base URL

```
http://localhost:3000/api
```

**Default Headers:**

```
Content-Type: application/json
```

---

## POST `/sort`

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

### Request

**URL:**

```
POST /sort
```


**Body Example:**

```json
{
  "input": [3, 1, 4, 1, 5, 9]
}
```

### Successful Response

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


## POST `/isOdd`

Checks if a given number is odd.

### Request

**URL:**

```
POST /isOdd
```

**Body Example:**

```json
{
  "input": 7
}
```

### Successful Response

```json
{
  "ret": true
}
```

---

## POST `/isEven`

Checks if a given number is even.

### Request

**URL:**

```
POST /isEven
```

**Body Example:**

```json
{
  "input": 4
}
```

### Successful Response

```json
{
  "ret": true
}
```

## POST `/toString`

calls .toString()

### Request

**URL:**

```
POST /toString
```

**Body Example:**

```json
{
  "input": 7
}
```

### Successful Response

```json
{
  "ret": "7"
}
```

## 📌 Example Usage with `curl`

### Sort an array (Linux/macOS)

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

### Check if odd

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

### Check if even

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