Update API docs of media with missing api (#1975)

This commit is contained in:
Bowrna 2024-08-06 11:41:13 +05:30 committed by GitHub
parent 1e6e97e750
commit e4dcb066d9
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -1,10 +1,11 @@
# API / Media # API / Media
Method | Endpoint | Description Method | Endpoint | Description
-------|------------------------------------------------|------------------------------ -------|------------------------------------------------------|---------------------------------
GET | [/api/media](#get-apimedia) | Get uploaded media file GET | [/api/media](#get-apimedia) | Get uploaded media file
POST | [/api/media](#post-apimedia) | Upload media file GET | [/api/media/{media_id}](#get-apimediamedia_id) | Get specific uploaded media file
DELETE | [/api/media/{media_id}](#delete-apimediamedia_id) | Delete uploaded media file POST | [/api/media](#post-apimedia) | Upload media file
DELETE | [/api/media/{media_id}](#delete-apimediamedia_id) | Delete uploaded media file
______________________________________________________________________ ______________________________________________________________________
@ -35,7 +36,42 @@ curl -u "username:password" -X GET 'http://localhost:9000/api/media' \
] ]
} }
``` ```
______________________________________________________________________
#### GET /api/media/{media_id}
Retrieve a specific media.
##### Parameters
| Name | Type | Required | Description |
|:--------------|:----------|:---------|:-----------------|
| media_id | Number | Yes | Media ID. |
##### Example Request
```shell
curl -u 'username:password' 'http://localhost:9000/api/media/7'
```
##### Example Response
```json
{
"data":
{
"id": 7,
"uuid": "62e32e97-d6ca-4441-923f-b62607000dd1",
"filename": "ResumeB.pdf",
"content_type": "application/pdf",
"created_at": "2024-08-06T11:28:53.888257+05:30",
"thumb_url": null,
"provider": "filesystem",
"meta": {},
"url": "http://localhost:9000/uploads/ResumeB.pdf"
}
}
```
______________________________________________________________________ ______________________________________________________________________
#### POST /api/media #### POST /api/media