Tài liệu API

API cho đại lý / developer theo chuẩn Perfect Panel. Panel khác chỉ cần thêm hacklike66 làm nhà cung cấp với URL và khoá API bên dưới.

Bắt đầu nhanh

Tạo khoá API

Vào trang Quản lý khoá API, đặt tên, đồng ý điều khoản, bấm Tạo. Sao chép khoá ngay.

Gửi yêu cầu POST

Gửi key + action tới URL API từ máy chủ của bạn (xem ví dụ mã ở cuối trang).

Theo dõi đơn

Tra trạng thái bằng action status. Trang Đơn của tôi trên web cũng liệt kê các đơn này (trang đang được hoàn thiện). Lỗi khi đặt đơn (gói không bảo hành, điều khoản mới…) sẽ chỉ rõ cần bấm gì ở trang Khoá API.

Dùng panel SMM chuẩn Perfect Panel? Thêm nhà cung cấp mới, dán URL API và khoá là xong — không cần lập trình.

Kết nối

URL API

https://api.hacklike66.com/api/v2

URL dự phòng

https://hacklike66.com/api/v2

Chỉ nhận POST. Gửi dạng form-urlencoded, JSON hoặc multipart.
Khoá gửi trong tham số key của thân yêu cầu, hoặc header X-Api-Key.
Tiền tệ VND. Mọi phản hồi là JSON.

Không bao giờ đưa khoá lên URL

Gọi kiểu ?key=... sẽ bị từ chối và hệ thống tự thu hồi khoá đó (vì URL bị lưu trong log). Khi đó bạn phải tạo khoá mới.

Chỉ gọi từ máy chủ

Gọi server-to-server. Không gọi từ trình duyệt hay ứng dụng khách (CORS bị chặn, và lộ khoá cho người khác).

Tiền tệ và giá

rate = giá VND cho 1.000 đơn vị. Ví dụ rate 15000, đặt 500 = 7.500 đ.
Giá là giá bán của chính tài khoản bạn (cùng giá bạn thấy trên web).
Muốn chắc không bị đổi giá giữa chừng, gửi kèm expected_rate khi đặt đơn.

Các action

Mọi yêu cầu đều gửi key + action. Bấm vào biểu tượng sao chép để lấy ví dụ.

services

Danh sách dịch vụ

Trả về các gói đang bán kèm giá của chính tài khoản bạn. Chỉ có gói thường (không có gói VIP). Xem fields để biết gói cần gửi thêm trường nào khi đặt đơn.

Tham số	Bắt buộc	Mô tả
key	Bắt buộc	Khoá API của bạn (hoặc gửi qua header X-Api-Key).
action	Bắt buộc	`services`

Phản hồi

[
  {
    "service": 12,
    "name": "Facebook - Like bài viết sv1",
    "type": "Default",
    "category": "Facebook - Like bài viết",
    "rate": "15000",
    "min": 50,
    "max": 10000,
    "refill": false,
    "cancel": false,
    "currency": "VND",
    "platform": "facebook",
    "desc": "Tóm tắt rủi ro của gói",
    "risk_level": "trung-binh",
    "risk_version": "a1b2c3d4e5f6",
    "warranty": false,
    "warranty_days": 0,
    "special_terms": null,
    "out_of_stock": false,
    "fields": [{ "name": "quantity", "required": true, "kind": "int" }]
  }
]

add

Tạo đơn

Tạo 1 đơn mới, trừ tiền từ số dư tài khoản. Trả về mã đơn.

Tham số	Bắt buộc	Mô tả
key	Bắt buộc	Khoá API của bạn (hoặc gửi qua header X-Api-Key).
action	Bắt buộc	`add`
service	Bắt buộc	Mã dịch vụ (trường service trong danh sách).
link	Bắt buộc	Link bài viết / trang / video cần tăng.
quantity	Bắt buộc	Số lượng, trong khoảng min–max. Gói bình luận không cần (số lượng = số dòng comments).
comments	Tuỳ loại	Gói bình luận: mỗi dòng 1 bình luận.
reaction, video_length, minutes, owner_link	Tuỳ loại	Chỉ gửi khi fields của gói có trường đó.
idempotency_key	Tuỳ chọn	8–64 ký tự `A-Z a-z 0-9 _ -`. Gửi lại cùng khoá thì không tạo đơn trùng. Không gửi thì hệ thống tự chống trùng 60 giây cho cùng nội dung.
expected_rate	Tuỳ chọn	Giá VND/1000 bạn đã xem. Nếu giá đã đổi, đơn bị từ chối và không trừ tiền.
risk_version	Tuỳ chọn	Ghim phiên bản Rủi ro & lưu ý bạn đã đọc (từ services).
target_uid	Tuỳ chọn	UID đối tượng (nếu bạn đã biết), giúp kiểm link chính xác hơn.

Phản hồi

{ "order": 23501 }

status

Trạng thái đơn

Xem trạng thái 1 đơn (order) hoặc nhiều đơn (orders=1,2,3, tối đa 100). charge là số tiền thực trừ sau khi đã hoàn.

Tham số	Bắt buộc	Mô tả
key	Bắt buộc	Khoá API của bạn (hoặc gửi qua header X-Api-Key).
action	Bắt buộc	`status`
order	Tuỳ loại	Mã 1 đơn.
orders	Tuỳ loại	Nhiều mã đơn, cách nhau dấu phẩy (tối đa 100).

Phản hồi 1 đơn

{ "charge": "7500", "start_count": "120", "status": "In progress", "remains": "300", "currency": "VND" }

Phản hồi nhiều đơn

{
  "1": { "charge": "7500", "start_count": "120", "status": "Completed", "remains": "0", "currency": "VND" },
  "2": { "error": "Incorrect order ID" }
}

balance

Số dư

Số dư hiện tại của tài khoản.

Tham số	Bắt buộc	Mô tả
key	Bắt buộc	Khoá API của bạn (hoặc gửi qua header X-Api-Key).
action	Bắt buộc	`balance`

Phản hồi

{ "balance": "250000", "currency": "VND" }

refill

Yêu cầu bảo hành

Chỉ dùng cho gói có bảo hành, đơn đã hoàn thành và còn trong hạn bảo hành; mỗi đơn 24 giờ được yêu cầu 1 lần. Qua API: mỗi đơn gửi tối đa 1 lần/15 phút (kể cả khi bị từ chối), mỗi khoá 60 đơn/giờ.

Tham số	Bắt buộc	Mô tả
key	Bắt buộc	Khoá API của bạn (hoặc gửi qua header X-Api-Key).
action	Bắt buộc	`refill`
order	Tuỳ loại	Mã 1 đơn.
orders	Tuỳ loại	Nhiều mã đơn, cách nhau dấu phẩy (tối đa 20).

Phản hồi 1 đơn

{ "refill": "88" }

Phản hồi nhiều đơn

[
  { "order": 1, "refill": "88" },
  { "order": 2, "refill": { "error": "..." } }
]

refill_status

Trạng thái bảo hành

Trạng thái 1 yêu cầu bảo hành (refill) hoặc nhiều yêu cầu (refills=1,2). Giá trị: Pending (chờ xử lý), In progress (đã gửi bảo hành), Rejected (bị từ chối).

Tham số	Bắt buộc	Mô tả
key	Bắt buộc	Khoá API của bạn (hoặc gửi qua header X-Api-Key).
action	Bắt buộc	`refill_status`
refill	Tuỳ loại	Mã 1 yêu cầu bảo hành.
refills	Tuỳ loại	Nhiều mã, cách nhau dấu phẩy.

Phản hồi 1 yêu cầu

{ "status": "In progress" }

Phản hồi nhiều yêu cầu

[
  { "refill": 88, "status": "In progress" },
  { "refill": 89, "status": { "error": "..." } }
]

cancel

Huỷ đơn

Chưa hỗ trợ — luôn trả về error. Phần chưa chạy của đơn bị huỷ/chạy thiếu được hệ thống tự hoàn.

Tham số	Bắt buộc	Mô tả
key	Bắt buộc	Khoá API của bạn (hoặc gửi qua header X-Api-Key).
action	Bắt buộc	`cancel`

Phản hồi

{ "error": "..." }

Trạng thái đơn

Giá trị status trả về khi tra đơn.

status	Ý nghĩa
Pending	Đã nhận đơn, đang chờ chuyển đi chạy.
Processing	Đang chuyển đơn cho hệ thống chạy.
In progress	Đang chạy.
Completed	Đã chạy xong.
Partial	Chạy được một phần; phần chưa chạy đã hoàn về số dư.
Canceled	Đã huỷ; phần chưa chạy đã hoàn về số dư.

Lỗi

Lỗi nghiệp vụ luôn trả HTTP 200 dạng {"error":"..."} (chuẩn Perfect Panel). Riêng gọi quá tần suất trả HTTP 429 kèm header Retry-After (số giây cần chờ); máy chủ tạm bận trả 503 {"error"}. Gọi từ trình duyệt (có header Origin lạ) bị chặn 403; JSON hỏng trả 400 — hãy gọi từ máy chủ và gửi JSON hợp lệ hoặc form. Python: dùng thư viện requests (như ví dụ) — urllib với User-Agent mặc định bị tường lửa Cloudflare chặn (403 “error code: 1010”), khi đó hãy đặt header User-Agent riêng. Trường type ngoài các loại chuẩn còn có Reaction, Reaction Comment,Like Comment Tiktok (xem fields của gói để biết tham số cần gửi).

Lỗi	Cách xử lý
Invalid API key	Khoá sai, đã thu hồi, hoặc IP gọi không nằm trong danh sách IP của khoá (cùng một câu báo). Kiểm tra lại khoá và IP ở trang Quản lý khoá API.
Incorrect service ID	Mã dịch vụ không tồn tại hoặc đã ngừng bán. Gọi lại services để lấy danh sách mới.
Incorrect order ID	Mã đơn không đúng hoặc không thuộc tài khoản của bạn.
Điều khoản đã cập nhật	Vào trang Quản lý khoá API, bấm Xác nhận lại ở khoá đó rồi gọi lại.
Gói không bảo hành	Khoá chưa bật ô chấp nhận gói không bảo hành. Tạo khoá mới có tick ô này, hoặc chọn gói có bảo hành.
Gói có điều khoản riêng	Khoá chưa đồng ý điều khoản riêng của nhóm dịch vụ đó. Xác nhận lại khoá và tick nhóm đó.
Số dư không đủ	Nạp thêm tiền vào tài khoản rồi đặt lại.
Link sai loại	Link không đúng loại gói yêu cầu; câu báo có kèm hướng dẫn link đúng.
Dịch vụ tạm hết	Gói đang tạm hết (out_of_stock). Chọn gói khác hoặc thử lại sau.

Mọi lỗi kiểu trên đều chưa trừ tiền

Sửa theo hướng dẫn rồi gửi lại. Dùng idempotency_key để gửi lại an toàn, không lo tạo đơn trùng.

Giới hạn

Mọi yêu cầu	120 yêu cầu / phút mỗi khoá
Tạo đơn (add)	30 đơn / phút và 600 đơn / giờ mỗi khoá
Sai khoá	20 lần / 10 phút từ 1 IP thì IP bị chặn 15 phút
Số khoá	Tối đa 5 khoá đang dùng mỗi tài khoản
Hạn mức tiền	Tuỳ chọn, đặt riêng cho từng khoá (VND / ngày)

Điều khoản và quyền lợi

Khi tạo khoá, bạn chấp nhận Điều khoản dịch vụ (đúng phiên bản lúc tạo) và chấp nhận áp dụng Rủi ro & lưu ý của từng gói như công bố trong services tại thời điểm đặt đơn.
Gói không bảo hành chỉ đặt được khi khoá bật ô chấp nhận gói không bảo hành.
Gói có điều khoản riêng cần đồng ý riêng nhóm đó khi tạo hoặc xác nhận lại khoá.
Điều khoản thay đổi thì khoá chuyển sang Cần xác nhận lại — vào trang Quản lý khoá API bấm Xác nhận lại.
Mỗi đơn lưu bản ghi lúc đặt (dịch vụ, rủi ro, giá, phiên bản điều khoản, IP gọi API) làm căn cứ khi khiếu nại.

Ví dụ mã

Tạo đơn bằng action add. Thay YOUR_API_KEY bằng khoá của bạn.

# Xem số dư
curl -X POST https://api.hacklike66.com/api/v2 -d key=YOUR_API_KEY -d action=balance

# Danh sách gói (lấy mã service, giá rate VND/1000, min, max)
curl -X POST https://api.hacklike66.com/api/v2 -d key=YOUR_API_KEY -d action=services

# Đặt đơn
curl -X POST https://api.hacklike66.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=12 \
  --data-urlencode link=https://www.facebook.com/xxx/posts/123 \
  -d quantity=500

Tạo khoá API Cần hỗ trợ