Tra Cứu Thông Tin Key & Quota: GET /v1/me

API cho phép truy vấn thông tin chi tiết về quyền hạn, danh sách sàn được cấp phép, giới hạn tốc độ RPM và số lượt tìm kiếm còn lại của API Key.

---

Thông Tin Endpoint

• Phương thức: GET
• Đường dẫn: /v1/me
• Xác thực: Header X-API-Key hoặc Authorization: Bearer
• Chi phí: 0 quota (Không bị trừ lượt tìm kiếm khi gọi)

---

1. Ví Dụ Request

cURL

curl -X GET "https://api.yourdomain.com/v1/me" \
  -H "X-API-Key: YOUR_API_KEY"

Python

import httpx

API_KEY = "YOUR_API_KEY"
response = httpx.get("https://api.yourdomain.com/v1/me", headers={"X-API-Key": API_KEY})
print(response.json())

JavaScript

const response = await fetch("https://api.yourdomain.com/v1/me", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
console.log(await response.json());

---

2. Cấu Trúc Response Trả Về

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

{
  "name": "Khách hàng Doanh Nghiệp VIP",
  "platforms": [
    "shopee",
    "tiktok"
  ],
  "rate_rpm": 120,
  "monthly_quota": 30000,
  "monthly_remaining": 28450,
  "daily_quota": 1000,
  "daily_remaining": 980,
  "status": "active",
  "expires_at": "2027-12-31T23:59:59Z"
}

Ý nghĩa các trường dữ liệu:

Tên trường	Kiểu dữ liệu	Mô tả
name	string	Tên mô tả hoặc tên khách hàng gắn với key
platforms	string[]	Danh sách sàn được phép truy cập (["shopee"], ["tiktok"], hoặc cả hai)
rate_rpm	integer	Giới hạn tốc độ gửi tối đa (Requests Per Minute)
monthly_quota	integer	Tổng hạn mức tháng được cấp
monthly_remaining	integer	Số lượt tìm kiếm còn lại trong chu kỳ tháng hiện tại
daily_quota	integer	Hạn mức ngày được cấu hình (nếu áp dụng)
daily_remaining	integer	Số lượt tìm kiếm còn lại trong ngày hôm nay
status	string	Trạng thái của khóa: "active" (đang hoạt động) hoặc "disabled" (tạm khóa)
expires_at	string | null	Thời điểm hết hạn (chuẩn ISO 8601 UTC) hoặc null nếu vô thời hạn

---

3. Các Headers Trả Về

Mỗi phản hồi từ /v1/me cũng đính kèm các Header theo dõi lưu lượng:

X-RateLimit-Limit: 120
X-Quota-Monthly-Limit: 30000
X-Quota-Monthly-Remaining: 28450