Thông báo

Developer Center

Tài liệu API tích hợp dịch vụ Social và mua sản phẩm Premium tự động dành cho các đại lý

V2
TÀI LIỆU API DỊCH VỤ SOCIAL
API Endpoint URL https://thatim.vn/api/v2
API Token Key
••••••••••••••••
HTTP Request Method
POST
application/x-www-form-urlencoded
Response Format
JSON
UTF-8 Character Encoding
Parameters
Parameter Type Description
key string API Key cá nhân của tài khoản
action string Đặt giá trị là "services"
Example Response
response.json 
[
    {
        "service": 1,
        "name": "Facebook Live Stream Views - Max 10K - [ 180 minutes ]",
        "type": "Default",
        "platform": "Facebook",
        "category": "Facebook  Live Stream Views",
        "details": "Nhập ID",
        "rate": "2.5",
        "min": "200",
        "max": "10000",
        "refill": true
    },
    {
        "service": 2,
        "name": "Tiktok Comments Viet Nam - Instant - 𝗥𝗘𝗙𝗜𝗟𝗟15Day - Max 50K",
        "type": "Custom Comments",
        "platform": "Tiktok",
        "category": "Tiktok Comments",
        "details": "Nhập link video",
        "rate": "4",
        "min": "10",
        "max": "1500",
        "refill": false
    }
]
Parameters
Parameter Type Description
key string API Key của bạn
action string Đặt giá trị là "add"
service int Mã ID máy chủ dịch vụ
link string Đường dẫn (URL) bài viết/video/kênh cần tăng
quantity int Số lượng muốn tăng (cần nằm trong min/max của máy chủ)
comments string Nội dung bình luận (nếu dịch vụ yêu cầu), phân tách bằng dòng \n
suggest string Danh sách đề xuất video gợi ý (nếu có)
search string Từ khóa tìm kiếm (nếu có)
Example Response
response.json 
{
    "order": 99999
}
Parameters
Parameter Type Description
key string API Key của bạn
action string Đặt giá trị là "status"
order int ID đơn hàng cần tra cứu
Trạng thái phản hồi bao gồm: Pending, Processing, In progress, Completed, Partial, Canceled.
Example Response
response.json 
{
    "charge": "2.5",
    "start_count": "168",
    "status": "Completed",
    "remains": "-2"
}
Parameters
Parameter Type Description
key string API Key của bạn
action string Đặt giá trị là "status"
orders string Danh sách các ID đơn hàng phân cách bằng dấu phẩy , (Tối đa 100 ID)
Example Response
response.json 
{
    "123": {
        "charge": "0.27819",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157"
    },
    "456": {
        "error": "Incorrect order ID"
    },
    "789": {
        "charge": "1.44219",
        "start_count": "234",
        "status": "In progress",
        "remains": "10"
    }
}
Parameters
Parameter Type Description
key string API Key của bạn
action string Đặt giá trị là "balance"
Example Response
response.json 
{
    "balance": "343423",
    "currency": "VND"
}
Parameters
Parameter Type Description
key string API Key của bạn
action string Đặt giá trị là "refill"
order int Mã đơn hàng cần yêu cầu bảo hành/bù (refill)
Example Response
response.json 
{
    "refill": "1"
}
Parameters
Parameter Type Description
key string API Key của bạn
action string Đặt giá trị là "refill"
orders string Mã các đơn cần bảo hành phân cách bằng dấu phẩy ,
Example Response
response.json 
{
    "refill": "1"
}
Parameters
Parameter Type Description
key string API Key của bạn
action string Đặt giá trị là "refill_status"
refill int Mã số (ID) refill cần tra cứu
Example Response
response.json 
{
    "status": "Completed"
}
Parameters
Parameter Type Description
key string API Key của bạn
action string Đặt giá trị là "refill_status"
refills string Chuỗi mã refill phân cách bằng dấu phẩy ,
Example Response
response.json 
[
    {
        "refill": 1,
        "status": "Completed"
    },
    {
        "refill": 2,
        "status": "Rejected"
    },
    {
        "refill": 3,
        "status": {
            "error": "Incorrect refill ID"
        }
    }
]
PRODUCT
TÀI LIỆU API MUA SẢN PHẨM
API Endpoint URL https://thatim.vn/api/product
API Token Key
••••••••••••••••
HTTP Request Method
GET / POST
Hỗ trợ cả hai giao thức nhận tin
Response Format
JSON
UTF-8 Character Encoding
Parameters
Parameter Type Description
key string API Key của bạn
action string Đặt giá trị là "category"
Example Response
response.json 
{
  "data": [
    {
      "id": 6,
      "name": "Youtube Premium",
      "slug": "youtube-premium",
      "price": "25000",
      "image": "https://thatim.vn/uploads/images/original/youtube.webp",
      "thumbnail": "https://thatim.vn/uploads/images/original/youtube-thumb.webp",
      "note": "Tài Khoản Youtube Premium Chính Chủ Đăng Ký Gmail Của Bạn",
      "desc": "MÔ TẢ SẢN PHẨM",
      "status": "selling",
      "time_data": [
        {
          "cycle_id": 1,
          "cycle": 360, //Ngày
          "price": 25000,
          "discount": 0,
          "note": "+ Tặng Kèm Canva Pro 1 Năm",
          "is_active": true
        },
        {
          "cycle_id": 3,
          "cycle": 360, //Ngày
          "price": 64500,
          "discount": -14,
          "note": "+ Tặng Kèm Canva Pro 1 Năm",
          "is_active": true
        }
      ]
    }
  ]
}
Parameters
Parameter Type Description
key string API Key của bạn
action string Đặt giá trị là "buy"
product int Mã số ID của sản phẩm (Lấy từ API Category)
cycle int Chu kỳ / Thời hạn mua (ví dụ: 1, 3, 6, 12 tháng)
note string Ghi chú hoặc thông tin bàn giao (ví dụ: gmail nhận gói)
Example Response
response.json 
{
  "status": "success",
  "message": "Đã đặt hàng thành công, cảm ơn quý khách đã sử dụng dịch vụ!",
  "data": {
    "order_id": 65,
    "order_code": "_8488103",
    "total": 25000
  },
  "responseTime": 892
}
Parameters
Parameter Type Description
key string API Key của bạn
action string Đặt giá trị là "history"
ids (Optional) string Chuỗi danh sách order_code phân tách bằng dấu phẩy (E.g: _8488103,_2887142). Bỏ trống để lấy toàn bộ lịch sử
Example Response
response.json 
{
  "status": "success",
  "message": "Lấy lịch sử đơn hàng thành công",
  "responseTime": 1747395629895,
  "data": [
    {
      "product_id": 6,
      "product_name": "Youtube Premium",
      "order_code": "_8488103",
      "price": "25000.00",
      "time_pay": "1",
      "status": "pending",
      "note": "test@gmail.com",
      "data": null,
      "created_at": "2025-05-16T11:39:37.000000Z"
    }
  ]
}