Upload API#
API upload ảnh lên hệ thống.
Base URL: https://app.socialking.vn/api/v1
1. Upload ảnh#
POST /upload/create
#
Auth: Bearer Token (JWT)
Rate Limit: 10 req/sec
Request: multipart/form-data
| Field | Type | Required | Validation |
|---|---|---|---|
files | File[] | Yes | Tối đa 100 files |
folderId | UUID | No | Nullable, folder đích |
Response (200):
{
"success": true,
"message": "Upload thành công 3/3 ảnh",
"data": {
"successful": [
{
"id": "uuid-string",
"filename": "product-image.png",
"url": "https://cdn.socialking.vn/uploads/product-image.png",
"size": 245760
}
],
"failed": [],
"statistics": {
"total": 3,
"successCount": 3,
"failCount": 0,
"totalDuration": "1.2s",
"averageDuration": "0.4s",
"throughput": "2.5 files/s"
}
}
}Errors:
| Code | Mô tả |
|---|---|
| 400 | File không hợp lệ (format, kích thước) |
| 413 | File quá lớn |
| 429 | Vượt quá rate limit |