Tải lên media (upload)
Tải ảnh, video hoặc tệp lên Omnichannel để lấy attachment_id, dùng khi gửi tin nhắn đính kèm.
Trước khi gửi tin nhắn có đính kèm (type: image hoặc file), bạn tải tệp lên để nhận attachment_id, sau đó truyền id này vào attachment_ids khi gọi gửi tin nhắn.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /v1/media | Tải lên một tệp media, trả về attachment_id (multipart/form-data) |
Tham số thân yêu cầu (multipart/form-data)
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
file | binary | Có | Tệp cần tải lên (ảnh/video/tài liệu) |
channel_id | string | Không | Gắn media với một kênh cụ thể |
Kiểm thử tại chỗ
POST
https://omni.hitechcloud.vn/v1/mediaKiểm thử tại chỗTải lên qua multipart/form-data. Token không được lưu lại.
Body
cURL tải ảnh lên
curl -X POST "https://omni.hitechcloud.vn/v1/media" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@/duong-dan/anh-san-pham.jpg" \
-F "channel_id=chn_01HZX8QWERTY"Phản hồi (201 Created)
{
"status": "success",
"data": {
"id": "att_01HZIMG01",
"type": "image",
"mime_type": "image/jpeg",
"size": 184203,
"url": "https://omni.hitechcloud.vn/media/att_01HZIMG01.jpg"
}
}Dùng
id trả về (ví dụ att_01HZIMG01) cho attachment_ids khi gọi gửi tin nhắn. Mỗi attachment_id dùng được trong vòng 24 giờ.Trước khi gửi tin nhắn có đính kèm (type: image hoặc file), bạn tải tệp lên để nhận attachment_id, sau đó truyền id này vào attachment_ids khi gọi gửi tin nhắn.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /v1/media | Tải lên một tệp media, trả về attachment_id (multipart/form-data) |
Tham số thân yêu cầu (multipart/form-data)
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
file | binary | Có | Tệp cần tải lên (ảnh/video/tài liệu) |
channel_id | string | Không | Gắn media với một kênh cụ thể |
Kiểm thử tại chỗ
POST
https://omni.hitechcloud.vn/v1/mediaKiểm thử tại chỗTải lên qua multipart/form-data. Token không được lưu lại.
Body
Dùng
id trả về (ví dụ att_01HZIMG01) cho attachment_ids khi gọi gửi tin nhắn. Mỗi attachment_id dùng được trong vòng 24 giờ.cURL tải ảnh lên
curl -X POST "https://omni.hitechcloud.vn/v1/media" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@/duong-dan/anh-san-pham.jpg" \
-F "channel_id=chn_01HZX8QWERTY"Phản hồi (201 Created)
{
"status": "success",
"data": {
"id": "att_01HZIMG01",
"type": "image",
"mime_type": "image/jpeg",
"size": 184203,
"url": "https://omni.hitechcloud.vn/media/att_01HZIMG01.jpg"
}
}