Hướng Dẫn Sử Dụng API: upload.upanhlaylink.com

API đơn giản để tải ảnh, quản lý token và lấy danh sách ảnh đã tải

Tổng Quan

API upload.upanhlaylink.com cho phép bạn tải ảnh lên, kiểm tra token API và lấy danh sách ảnh đã tải. API hỗ trợ tải ảnh qua tệp hoặc URL, với tùy chọn chọn giữa hai máy chủ (server_1 hoặc server_2). Đây là giải pháp lý tưởng cho các ứng dụng cần lưu trữ và quản lý ảnh.

URL Cơ Bản

https://upload.upanhlaylink.com

Xác Thực

Tất cả yêu cầu API đều cần tham số token hợp lệ. Sử dụng endpoint /api/check_token để kiểm tra token.

Các Endpoint

1. Tải Ảnh Lên

Tải ảnh lên máy chủ được chỉ định, bằng cách cung cấp tệp ảnh hoặc URL ảnh.

Endpoint

POST /upload

Tham Số

Tham Số Kiểu Bắt Buộc Mô Tả
token Chuỗi Có Token API để xác thực.
images Tệp Không Tệp ảnh để tải lên.
image_url Chuỗi Không URL của ảnh để tải lên.
server Chuỗi Có Máy chủ để tải lên (server_1 hoặc server_2).

Lưu ý: Cần cung cấp images hoặc image_url, nhưng không được cung cấp cả hai.

Ví Dụ Yêu Cầu (cURL)

curl -X POST https://upload.upanhlaylink.com/upload \
  -F "token=1a348e58e9ffd43c67753529fa0bd3da9fa64f605209188f7a2d49f421c43be6" \
  -F "images=@/đường/dẫn/đến/ảnh.jpg" \
  -F "server=server_1"

Phản Hồi

{
  "success": true,
  "results": [
    {
      "success": true,
      "filename": "image_202504293c0fc3be8e43849a9157eaae9a95ef62.jpg",
      "url": "https://cdn-img.upanhlaylink.com/img/image_202504293c0fc3be8e43849a9157eaae9a95ef62.jpg"
    }
  ]
}

2. Kiểm Tra Token

Xác thực token API và lấy số lượng tải lên còn lại.

Endpoint

GET /api/check_token

Tham Số

Tham Số Kiểu Bắt Buộc Mô Tả
token Chuỗi Có Token API để xác thực.

Ví Dụ Yêu Cầu (cURL)

curl -X GET "https://upload.upanhlaylink.com/api/check_token?token=1a348e58e9ffd43c67753529fa0bd3da9fa64f605209188f7a2d49f421c43be6"

Phản Hồi

{
  "success": true,
  "token": "1a348e58e9ffd43c67753529fa0bd3da9fa64f605209188f7a2d49f421c43be6",
  "quantity": 9992
}

3. Lấy Danh Sách Ảnh Đã Tải

Lấy danh sách ảnh đã tải lên theo trang, liên kết với token được cung cấp.

Endpoint

GET /api/check_img

Tham Số

Tham Số Kiểu Bắt Buộc Mô Tả
token Chuỗi Có Token API để xác thực.
page Số nguyên Có Số trang cho phân trang.
litmit Số nguyên Có Số lượng ảnh trả về (tối đa 10).

Lưu ý: Tham số litmit có thể là lỗi đánh máy; có thể là limit.

Ví Dụ Yêu Cầu (cURL)

curl -X GET "http://upload.upanhlaylink.com/api/check_img?token=1a348e58e9ffd43c67753529fa0bd3da9fa64f605209188f7a2d49f421c43be6&page=1&litmit=10"

Phản Hồi

{
  "success": true,
  "token": "1a348e58e9ffd43c67753529fa0bd3da9fa64f605209188f7a2d49f421c43be6",
  "total_size_kb": 4868,
  "pagination": {
    "current_page": 1,
    "per_page": 10,
    "total_images": 8,
    "total_pages": 1
  },
  "images": [
    {
      "filename": "image_20250429f2f6bb35576b3cf8fb6a8b71718ef004.jpg",
      "url": "https://cdn-img.upanhlaylink.com/img/image_20250429f2f6bb35576b3cf8fb6a8b71718ef004.jpg",
      "size_kb": 479,
      "dimensions": "1125 x 750",
      "uploaded_at": "2025-04-29 03:01:41"
    },
    ...
  ]
}

Bắt Đầu

Yêu Cầu Trước

  • Một token API hợp lệ (ví dụ: 1a348e58e9ffd43c67753529fa0bd3da9fa64f605209188f7a2d49f421c43be6).
  • Công cụ hoặc thư viện để gửi yêu cầu HTTP (ví dụ: cURL, Postman, JavaScript, Python).
  • Đối với tải tệp, đảm bảo tệp ảnh có thể truy cập và ở định dạng hỗ trợ (ví dụ: JPG, PNG).

Lấy Token

Nhấn nút dưới đây để lấy token API. Token sẽ được reset số lần sử dụng sau 12 giờ đêm mỗi ngày.

Liên hệ qua Telegram

Các Bước Sử Dụng API

  1. Lấy Token: Nhấn nút "Lấy Token" hoặc liên hệ qua Telegram để nhận token API hợp lệ và kiểm tra bằng /api/check_token.
  2. Tải Ảnh Lên: Sử dụng /upload để tải ảnh, chỉ định tệp hoặc URL và máy chủ.
  3. Lấy Danh Sách Ảnh: Sử dụng /api/check_img để lấy danh sách ảnh đã tải với phân trang.

Quy Trình Ví Dụ

# Kiểm tra token
curl -X GET "https://upload.upanhlaylink.com/api/check_token?token=your_token"

# Tải ảnh lên
curl -X POST https://upload.upanhlaylink.com/upload \
  -F "token=your_token" \
  -F "images=@ảnh.jpg" \
  -F "server=server_1"

# Lấy danh sách ảnh
curl -X GET "http://upload.upanhlaylink.com/api/check_img?token=your_token&page=1&litmit=10"

Xử Lý Lỗi

Ghi Chú

Hỗ Trợ

Nếu gặp vấn đề hoặc có câu hỏi, liên hệ với đội ngũ hỗ trợ qua Telegram. Kiểm tra tài liệu chính thức hoặc diễn đàn cộng đồng để cập nhật.