Tài liệu API Upload Ảnh

Tổng quan về API

API này dùng để upload file ảnh lên server, hỗ trợ nhiều định dạng ảnh khác nhau.

Chi tiết API

Thông tin Request

URL: https://imageproxy.zhongzhuan.chat/api/upload

Phương thức: POST

Content-Type: multipart/form-data

Tham số Request

Tên tham số	Kiểu dữ liệu	Bắt buộc	Mô tả
file	File	Có	File ảnh cần upload

Ví dụ Request

Ví dụ cURL

Ví dụ JavaScript

Ví dụ Python

Thông tin Response

Response thành công

HTTP Status Code: 200 OK

Định dạng response: JSON

Tên trường	Kiểu dữ liệu	Mô tả
url	String	Đường dẫn truy cập ảnh sau khi upload thành công
created	Number	Timestamp thời điểm tạo (millisecond)

Ví dụ Response

{
    "url": "https://imageproxy.zhongzhuan.chat/api/proxy/image/2316ce07a01000cf14a628c8b29e97a8",
    "created": 1757403998946
}

Response lỗi

Các status code lỗi có thể xảy ra:

Status code	Mô tả
400	Tham số request không hợp lệ (ví dụ: chưa cung cấp file)
413	File quá lớn
415	Định dạng file không được hỗ trợ
500	Lỗi nội bộ server

Ví dụ Response lỗi

{
    "error": "Định dạng file không được hỗ trợ",
    "code": 415
}

Hướng dẫn sử dụng

Định dạng file được hỗ trợ: Các định dạng ảnh phổ biến như JPG, PNG, GIF, WebP, v.v.

Giới hạn kích thước file: Khuyến nghị mỗi file không vượt quá 10MB

URL trả về: Có thể dùng trực tiếp để hiển thị ảnh, đường dẫn có hiệu lực lâu dài

Định dạng timestamp: Unix timestamp, đơn vị millisecond

Lưu ý

Ảnh được upload sẽ được xử lý qua dịch vụ proxy, đảm bảo tính ổn định khi truy cập

Khuyến nghị nén ảnh ở phía client trước khi upload để tăng tốc độ upload

Đường dẫn ảnh trả về hỗ trợ truy cập cross-origin

Trước khi upload, hãy đảm bảo có kết nối mạng và quyền truy cập phù hợp

API tự xây dựng lưu trữ hình ảnh

Tài liệu API Upload Ảnh#

Tổng quan về API#

Chi tiết API#

Thông tin Request#

Tham số Request#

Ví dụ Request#

Ví dụ cURL#

Ví dụ JavaScript#

Ví dụ Python#

Thông tin Response#

Response thành công#

Ví dụ Response#

Response lỗi#

Ví dụ Response lỗi#

Hướng dẫn sử dụng#

Lưu ý#