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