Tổng quan API

API này cung cấp chức năng chuyển đổi URL hình ảnh, cho phép bạn tải lên và chuyển đổi một URL hình ảnh từ bên ngoài thành URL mới được lưu trữ trên máy chủ của chúng tôi.

Endpoint này sử dụng phương thức GET và nhận một tham số truy vấn là url chứa URL hình ảnh cần chuyển đổi.

Lưu ý quan trọng: API chỉ hỗ trợ các định dạng hình ảnh, video, âm thanh, ..., được công khai.

GET
/api/convert?url=<URL_HÌNH_ẢNH_CẦN_CHUYỂN_ĐỔI>

Tham số

Tên tham số Vị trí Bắt buộc Mô tả Ví dụ
url Query Bắt buộc URL hình ảnh cần chuyển đổi. URL phải được mã hóa đúng cách (URL encoded) và phải trỏ trực tiếp đến tệp hình ảnh. https://example.com/images/photo.jpg

Ví dụ sử dụng

Yêu cầu cURL
curl -X GET "/api/convert?url=https%3A%2F%2Fi.ibb.co%2FJWLLvHf8%2Flogo.jpg"
JavaScript (Fetch API)
const imageUrl = encodeURIComponent('https://i.ibb.co/JWLLvHf8/logo.jpg'); fetch(`/api/convert?url=${imageUrl}`) .then(response => response.json()) .then(data => { console.log('URL gốc:', data.originalUrl); console.log('URL mới:', data.convertedUrl); }) .catch(error => console.error('Lỗi:', error));
Python (Requests)
import requests from urllib.parse import quote base_url = "/api/convert" image_url = "https://i.ibb.co/JWLLvHf8/logo.jpg" encoded_url = quote(image_url, safe='') try: response = requests.get(f"{base_url}?url={encoded_url}") data = response.json() print("URL gốc:", data["originalUrl"]) print("URL mới:", data["convertedUrl"]) except Exception as e: print("Lỗi:", str(e))

Phản hồi thành công

API sẽ trả về dữ liệu dạng JSON với cấu trúc sau khi thành công:

{ "success": true, "originalUrl": "https://i.ibb.co/JWLLvHf8/logo.jpg", "convertedUrl": "/uploads/converted-1749108026752-lb3ygu0p2.jpg" }

Định nghĩa phản hồi

Thuộc tính Kiểu dữ liệu Mô tả
success boolean Trạng thái của yêu cầu (true = thành công, false = thất bại)
originalUrl string URL hình ảnh gốc được cung cấp trong yêu cầu
convertedUrl string Đường dẫn tương đối của hình ảnh sau khi đã được tải lên và chuyển đổi

Phản hồi lỗi

Khi có lỗi xảy ra, API sẽ trả về dữ liệu dạng JSON với cấu trúc sau:

{ "success": false, "error": "Mô tả lỗi chi tiết", "code": "Mã lỗi (nếu có)" }

Mã trạng thái

200 OK

Yêu cầu thành công. Hình ảnh đã được chuyển đổi và URL mới trả về trong phản hồi.

400 Bad Request

Yêu cầu không hợp lệ. Thường do: thiếu tham số url, URL không đúng định dạng, không phải URL hình ảnh, hoặc hình ảnh vượt quá kích thước cho phép.

404 Not Found

Không tìm thấy hình ảnh tại URL cung cấp hoặc URL không tồn tại.

500 Internal Server Error

Lỗi máy chủ nội bộ. Có sự cố xảy ra khi xử lý yêu cầu.

Lưu ý bảo mật: API này chỉ chấp nhận các URL hình ảnh từ các nguồn công khai. Không sử dụng API để tải lên hình ảnh từ các nguồn yêu cầu xác thực hoặc hình ảnh nhạy cảm.