UpAnhLayLink Developer API v1

Tài Liệu Tích Hợp API Upload

Dễ dàng upload hình ảnh tự động, lưu trữ mã hóa AES-256 an toàn và nhận link trực tiếp tốc độ cao để nhúng vào website, app, diễn đàn hoặc bot của bạn.

Khóa Xác Thực Cá Nhân (API Key)

Đăng nhập vào tài khoản để nhận API Key cá nhân và sử dụng trực tiếp trong mã tích hợp.

Xác Thực Hai Đầu

Hỗ trợ xác thực linh hoạt qua Header X-API-Key hoặc Bearer Token Authorization: Bearer <key>.

Hạn Mức & Tốc Độ Cao

Hạn mức tính theo phút độc lập cho từng tài khoản, tự động hồi phục tức thì mà không lo bị khóa theo ngày.

Các API Endpoints & Mã Mẫu

Chọn ngôn ngữ lập trình bạn muốn tích hợp:

POST/api/v1/images/upload

Tải lên file ảnh từ máy (Multipart)

Gửi một hoặc nhiều tệp hình ảnh (JPEG, PNG, GIF, WebP, SVG) qua định dạng multipart/form-data. Kích thước file tối đa phụ thuộc vào gói cước của tài khoản.

CURL CODE

curl -X POST "https://apiusercontent.upanhlaylink.com/api/v1/images/upload" \
  -H "X-API-Key: upl_live_YOUR_API_KEY" \
  -F "files=@/path/to/image.png"

Kết quả JSON Trả Về (200 OK):

{
  "message": "Tải lên 1 ảnh thành công",
  "images": [
    {
      "id": 1420,
      "slug": "l7cI1gxP",
      "original_name": "photo.jpg",
      "size_bytes": 1048576,
      "direct_url": "https://cdn.upanhlaylink.com/i/l7cI1gxP.jpg",
      "raw_url": "https://cdn.upanhlaylink.com/raw/l7cI1gxP",
      "thumb_url": "https://cdn.upanhlaylink.com/raw/l7cI1gxP",
      "bbcode": "[img]https://cdn.upanhlaylink.com/i/l7cI1gxP.jpg[/img]",
      "markdown": "![photo](https://cdn.upanhlaylink.com/i/l7cI1gxP.jpg)",
      "html": "<img src=\"https://cdn.upanhlaylink.com/i/l7cI1gxP.jpg\" alt=\"photo\" />",
      "status": "on",
      "created_at": "2026-09-23T08:00:00Z"
    }
  ]
}

POST/api/v1/images/upload-url

Tải và lưu trữ ảnh từ URL công khai

Server sẽ tự động fetch ảnh từ đường dẫn Internet bạn cung cấp, kiểm tra dung lượng theo gói và lưu trữ mã hóa an toàn.

CURL CODE

curl -X POST "https://apiusercontent.upanhlaylink.com/api/v1/images/upload-url" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: upl_live_YOUR_API_KEY" \
  -d '{"url": "https://example.com/sample.jpg"}'

GET/api/v1/images

Lấy danh sách ảnh trong tài khoản

Truy vấn danh sách ảnh cá nhân với phân trang (page, limit) và tìm kiếm theo tên (search).

CURL CODE

curl -X GET "https://apiusercontent.upanhlaylink.com/api/v1/images?page=1&limit=20" \
  -H "X-API-Key: upl_live_YOUR_API_KEY"

DELETE/api/v1/images/:id

Xóa ảnh vĩnh viễn

Xóa bỏ ảnh và liên kết khỏi máy chủ. Bạn chỉ có quyền xóa các ảnh thuộc quyền sở hữu của chính mình.

CURL CODE

curl -X DELETE "https://apiusercontent.upanhlaylink.com/api/v1/images/123" \
  -H "X-API-Key: upl_live_YOUR_API_KEY"

Bảng Hạn Mức Tải Lên Theo Gói Cước

Mỗi tài khoản được cấp quota tự động hồi phục sau mỗi 60 giây:

Gói Cước	Giá Cước	Giới Hạn Upload / Phút	Dung Lượng Max / File	API Key & Batch Cloud	Độ Ưu Tiên
👻 Khách Vãng Lai	Miễn phí (0đ)	10 lượt / phút	5 MB / ảnh	Không hỗ trợ API	Tiêu chuẩn
Thành Viên Thường (FREE)	0đ / Vĩnh viễn	30 lượt / phút	15 MB / ảnh	✓ Có API Key riêng	Cao
Gói VIP / Doanh Nghiệp	49.000 đ / tháng 490.000 đ / năm Nâng cấp VIP	120+ lượt / phút	50 MB+ / ảnh	✓ Có API Key & Tùy biến	Ưu tiên cao nhất

Mã Trạng Thái HTTP (Status Codes)

200 OK

Yêu cầu thành công, dữ liệu JSON chứa direct link ảnh.

401 Unauthorized

API Key không hợp lệ hoặc chưa được cung cấp qua header.

413 Payload Too Large

Kích thước ảnh vượt quá giới hạn tối đa cho phép theo gói.

429 Rate Limit

Vượt quá số lượt upload / phút. Vui lòng chờ 60s để hồi quota.