Chuyển tới nội dung chính

Upload hình ảnh

mẹo

Bạn có thể sử dụng API upload hình ảnh để phục vụ việc gửi thông báo đính kèm ảnh.

Lưu ý

Ảnh sau khi được upload và gửi đến người dùng sẽ được lưu trên server tối đa 7 ngày. Trường hợp người dùng xem lại ảnh sau khoảng thời gian trên sẽ được thông báo ảnh không còn tồn tại.

Quota cho API là:

  • 5000 request/ tháng.

Quyền cần có: Quyền gửi tin và thông báo qua OA

HTTP request​

Example request​

curl \
-H 'access_token: <your_access_token>' \
-F "file=@/home/test.jpg" \
https://openapi.zalo.me/v2.0/oa/upload/image

Tham số header​

Tham sốKiểu dữ liệuTính bắt buộcMô tả
access_token

string

yes

Token cho phép ứng dụng đại diện OA gọi API. Xem chi tiết cách lấy access token tại đây.

Cấu trúc body của request​

Tham sốLoại Tính bắt buộcMô tả

file

binary

yes

Nội dung nhị phân của file ảnh

Các định dạng ảnh hỗ trợ: jpg và png

Dung lượng tối đa: 1MB

Example respond​

{
"data": {
"attachment_id": "wESbL53O_shdvIPILC7iR_JpC552r_fjukKg"
},
"error": 0,
"message": "Success"
}

Cấu trúc thuộc tính data​

Thuộc tínhKiểu dữ liệuMô tả

attachment_id

string

ID của ảnh được upload