Về trang chủ

Tài liệu API

API REST Index Tức Thì — phiên bản 1

Bắt đầu nhanh

1. Lấy một khóa API

Có ở mọi gói, trong Bảng điều khiển → Hồ sơ → Truy cập API.

2. Gửi URL của bạn

Một request POST tới endpoint gửi URL. Tối đa 500 URL mỗi request, xử lý theo lô 3.

3. Theo dõi việc thu thập dữ liệu

Lịch sử cho biết từng URL đang ở trạng thái nào. Lịch sử được giữ 48 giờ.

Xác thực

Các endpoint cần xác thực đọc khóa của bạn từ header Authorization: Bearer. Khóa bắt đầu bằng ixvi_ và được tạo trong Bảng điều khiển → Hồ sơ → Truy cập API.

# Khóa API xác thực cho mọi request của bạn
curl https://indextucthi.com/api/user/credits \
  -H "Authorization: Bearer ixvi_KHOA_API_CUA_BAN"

Khóa API của bạn có giá trị như mật khẩu: đừng bao giờ đặt nó trong code chạy ở trình duyệt, trong một repo công khai hay trong một URL. Nếu khóa bị lộ, hãy tạo lại từ bảng điều khiển — khóa cũ ngừng hoạt động ngay lập tức.

Giới hạn

500

URL mỗi request

3 URL

Kích thước lô

48 giờ

Lịch sử lưu giữ

10 req/s

Tốc độ

Endpoints

POST/api/indexing/submitCần khóa API

Gửi URL

Gửi tối đa 500 URL tới Google. Chúng được xếp hàng và xử lý theo lô 3 URL.

Nội dung request

{
  "urls": [
    "https://trangcuaban.vn/bai-viet-1",
    "https://trangcuaban.vn/bai-viet-2",
    "https://trangcuaban.vn/bai-viet-3"
  ]
}

Phản hồi

{
  "success": true,
  "submitted": 3,
  "failed": 0,
  "creditsUsed": 3,
  "remainingCredits": 61,
  "results": [
    { "url": "https://trangcuaban.vn/bai-viet-1", "status": "submitted" },
    { "url": "https://trangcuaban.vn/bai-viet-2", "status": "submitted" },
    { "url": "https://trangcuaban.vn/bai-viet-3", "status": "submitted" }
  ]
}

Lỗi

  • 400Không có URL hợp lệ nào được gửi
  • 402Không đủ tín dụng
  • 429Quá nhiều request — hãy gửi chậm lại
  • 503Dịch vụ index không khả dụng
GET/api/indexing/history?page=1&limit=20Cần khóa API

Xem lịch sử

Lấy danh sách các lần gửi của bạn, có phân trang. URL được lưu trong 48 giờ.

Phản hồi

{
  "submissions": [
    {
      "_id": "abc123",
      "url": "https://trangcuaban.vn/bai-viet-1",
      "status": "submitted",
      "searchEngine": "google",
      "creditsUsed": 1,
      "createdAt": "2026-09-07T12:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "pages": 3
  }
}

Lỗi

  • 401Thiếu khóa API hoặc khóa không hợp lệ
GET/api/user/creditsCần khóa API

Xem số dư của bạn

Trả về số tín dụng còn lại, gói bạn đang dùng và chi phí cho một lần gửi.

Phản hồi

{
  "credits": 80,
  "planName": "Khởi đầu",
  "planExpiresAt": "2099-12-31T00:00:00Z",
  "creditCosts": { "credit_cost_url_indexing": 1 }
}

Lỗi

  • 401Thiếu khóa API hoặc khóa không hợp lệ
GET/api/plansPublic

Liệt kê các gói

Trả về tất cả các gói đang hoạt động. Không cần xác thực.

Phản hồi

{
  "plans": [
    {
      "name": "Khởi đầu",
      "price": 5,
      "credits": 80,
      "currency": "USD",
      "billingPeriod": "lifetime",
      "features": ["80 tín dụng index", "…"]
    }
  ]
}

Bạn có câu hỏi về API? Hãy viết cho chúng tôi, chúng tôi trả lời trong vòng 24 giờ.