Upload file

mẹo

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

Lưu ý

File 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 file sau khoảng thời gian trên sẽ được thông báo file 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

• URL: https://openapi.zalo.me/v2.0/oa/upload/file
• Method: POST
• Content Type: multipart/form-data
• Response Type: text/json

Example request

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

Tham số header

Tham số	Kiểu dữ liệu	Tính bắt buộc	Mô 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ộc	Mô tả
file	binary	yes	Nội dung nhị phân của file Lưu ý: Chỉ hỗ trợ file PDF/DOC/DOCX/CSV, dung lượng file không vượt quá 5MB

Example respond

{
  "data": {
    "token": "hDtMfuo7XKzhraJb6jm53AiDncIQ1aSOQp9FHOROFisDP7m64BxCKe"
  },
  "error": 0,
  "message": "Success"
}

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

Thuộc tính	Kiểu dữ liệu	Mô tả
token	string	Token của file, sử dụng cho API gửi thông báo đính kèm file.