Tài liệu API

Tích hợp IndexTensor vào ứng dụng của bạn với REST API đơn giản của chúng tôi.

Xác thực

Mọi yêu cầu API đều yêu cầu xác thực token Bearer. Đưa token API vào header Authorization:

Authorization: Bearer YOUR_API_TOKEN

Đăng nhập để lấy token API.

Endpoint

POST /api/links

Gửi liên kết để lập chỉ mục. Liên kết có thể cung cấp dưới dạng chuỗi phân tách bằng dấu chấm phẩy hoặc mảng.

Nội dung yêu cầu

// Option 1: Semicolon-separated string
{
  "links": "https://example.com/page1;https://example.com/page2"
}

// Option 2: Array of links
{
  "links": [
    "https://example.com/page1",
    "https://example.com/page2"
  ]
}

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

{
  "status": 200,
  "msg": "Task created successfully",
  "data": {
    "units_used": 4,
    "task_id": "1721392204",
    "links_count": 4
  }
}

Mã lỗi

Mô tả
400 Dữ liệu không hợp lệ (JSON sai định dạng, URL không hợp lệ)
401 Header Authorization thiếu hoặc sai định dạng
403 Token API không hợp lệ
404 Không tìm thấy endpoint
405 Số dư không đủ
429 Vượt giới hạn tốc độ
500 Lỗi máy chủ nội bộ

Định dạng phản hồi lỗi

{
  "status": 400,
  "message": "Task wasn't created: Invalid data provided"
}

Giới hạn tốc độ và ràng buộc

  • Số liên kết tối đa mỗi yêu cầu: 20,000
  • Độ dài URL tối đa: 2,000 characters
  • Giao thức hỗ trợ: http:// and https://
  • Chi phí: 1 đơn vị mỗi liên kết
  • Giới hạn tốc độ: 60 yêu cầu mỗi phút

Ví dụ mã

curl -X POST https://indextensor.com/api/links \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"links": ["https://example.com/page1", "https://example.com/page2"]}'