105 lines
2.6 KiB
Markdown
105 lines
2.6 KiB
Markdown
# API documentation of Akf-forum
|
|
Akf-forum has got an API for AJAX, other clients etc.
|
|
|
|
## Authorization
|
|
You need this header for send request to API:
|
|
```json
|
|
{
|
|
"authorization": "Basic <base64 encoded username:password>"
|
|
}
|
|
```
|
|
|
|
But in front end, the API will works with session.
|
|
|
|
## Default Limits:
|
|
- 3 - 25 char for username, password and category name
|
|
- 256 char for user about and desp of category
|
|
- 5 - 128 char for thread titles.
|
|
- 5 - 1024 char for messages.
|
|
|
|
You can change them in config.json.
|
|
|
|
## How to request?
|
|
### Request types:
|
|
#### `/api/me`
|
|
- GET `/api/me` to get your account.
|
|
|
|
#### `/api/config`
|
|
- GET `/` to reach config file.
|
|
- PUT `/` to edit config file.
|
|
|
|
#### `/api/bans`
|
|
- GET `/` fetch all bans.
|
|
- GET `/:ip` fetch a ban.
|
|
- DELETE `/:ip` for unban an IP adress.
|
|
- POST `/?reason=flood` for ban an IP adress.
|
|
|
|
#### `/api/categories`
|
|
- GET `/` fetch all categories.
|
|
- GET `/:id` fetch a category
|
|
- PATCH `/:id` for update a category.
|
|
- DELETE `/:id` for delete a category.
|
|
- POST `/` for create a category.
|
|
|
|
#### `/api/messages`
|
|
- GET `/:id` for fetch message.
|
|
- DELETE `/:id` for delete message.
|
|
- PATCH `/:id` for edit message.
|
|
- POST `/:id/react/:type` for react to a message.
|
|
- POST `/` for create message.
|
|
|
|
#### `/api/search` use `?limit=&skip=` for skip and limit
|
|
- GET `/users?q=query` find users.
|
|
- GET `/threads?q=query&authorID=not_required` find threads.
|
|
- GET `/messages?q=query&authorID=not_required` find messages.
|
|
|
|
#### `/api/threads`
|
|
- GET `/:id` for fetch thread.
|
|
- DELETE `/:id` for delete thread.
|
|
- PATCH `/:id` for edit thread.
|
|
- GET `/:id/messages?skip=0&limit=10` for fetch messages in thread.
|
|
- POST `/` for create thread.
|
|
|
|
#### `/api/users`
|
|
- GET `/:id` for fetch user.
|
|
- DELETE `/:id` for delete user.
|
|
- PATCH `/:id` for edit user.
|
|
- PUT `/:id` for add profile photo to user.
|
|
- POST `/:id/ban` for ban all ips of user.
|
|
|
|
### Example request:
|
|
GET ```/api/messages/0```
|
|
|
|
#### Example API Output:
|
|
```js
|
|
{
|
|
"react": {
|
|
"like": [],
|
|
"dislike": ["0"]
|
|
},
|
|
"_id": "6325c216faa938c4cfc43075",
|
|
"author": {
|
|
"_id": "632e028ca4ba362ebbb75a43",
|
|
"name": "Akif9748",
|
|
"avatar": "/images/avatars/0.jpg",
|
|
"deleted": false,
|
|
"edited": true,
|
|
"about": "# Owner",
|
|
"admin": true,
|
|
"theme": "black",
|
|
"hideLastSeen": false,
|
|
"time": "2022-09-23T19:01:32.610Z",
|
|
"id": "0",
|
|
"__v": 0,
|
|
"discordID": "539506680140922890"
|
|
},
|
|
"threadID": "0",
|
|
"content": "This is a thread opened via API, yes",
|
|
"deleted": false,
|
|
"edited": true,
|
|
"time": "2022-09-17T12:48:22.378Z",
|
|
"id": "0",
|
|
"__v": 4,
|
|
"oldContents": []
|
|
}
|
|
``` |