Tích hợp API

Bắt đầu nhanh

1. Tạo API key tại Tích hợp API trong tài khoản (key chỉ hiển thị một lần khi tạo).
2. Gọi action=services để lấy danh mục và lưu service ID của các dịch vụ bạn bán.
3. Tạo đơn bằng action=add, sau đó theo dõi bằng action=status (khuyến nghị mỗi 1–5 phút).

curl https://api.like360.net/api/v2 -d key=YOUR_API_KEY -d action=balance
# → { "balance": "1500000.0000", "currency": "VND" }

Xác thực

Mỗi yêu cầu cần một API key. Gửi key theo một trong ba cách (ưu tiên theo thứ tự):

• Tham số key trong body (chuẩn SMM panel, tương thích mã có sẵn).
• Header X-Api-Key: YOUR_API_KEY.
• Header Authorization: Bearer YOUR_API_KEY.

Tạo và quản lý key tại Tích hợp API trong tài khoản. Key chỉ hiển thị một lần khi tạo, nên lưu lại nơi an toàn.

Mỗi key gắn với tài khoản, số dư và website đã cấp key. Key bị thu hồi sẽ ngừng hoạt động ngay lập tức. API chỉ nhận POST - key nằm trong body hoặc header nên không bao giờ lọt vào URL hay log trung gian.

Quy ước chung

• Phương thức: chỉ POST (gọi GET trả về 405).
• Định dạng: phản hồi luôn là JSON.
• Lỗi: trả về HTTP 200 với body { "error": "..." } (quy ước SMM panel - đừng dựa vào HTTP status code). Luôn kiểm tra trường error trước khi xử lý.
• Đơn giá (rate): là giá cho một đơn vị (1 like, 1 follow), tính theo VND.
• Tiền tệ: VND.
• Idempotency: thêm idempotency_key khi add để chống tạo trùng nếu phải gửi lại. Cửa sổ replay là 10 phút - gửi lại cùng key đó trong 10 phút sẽ nhận về đúng mã đơn cũ.
• Giới hạn tần suất: tối đa 10 yêu cầu / giây cho mỗi key; vượt sẽ nhận Rate limit exceeded, slow down. Khi tra cứu nhiều đơn, gộp bằng orders thay vì gọi từng đơn.

POST Danh sách dịch vụ services

Trả về các dịch vụ đang bán và đang có nguồn cung, kèm đơn giá và giới hạn số lượng. Dịch vụ hết nguồn tạm thời sẽ không xuất hiện - nên đồng bộ định kỳ (vd mỗi giờ) thay vì lưu cứng danh mục. refill = dịch vụ có bảo hành bù tụt tự động; cancel hiện luôn là false (hủy qua API chưa mở).

Tham số

Ví dụ

curl https://api.like360.net/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=services

Phản hồi

[
  {
    "service": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
    "name": "TikTok Followers",
    "category": "Followers",
    "rate": "30.0000000",
    "min": 10,
    "max": 100000,
    "refill": true,
    "cancel": false
  }
]

POST Số dư balance

Tham số

Phản hồi

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

POST Tạo đơn add

Tạo đơn và tự động xử lý, trừ vào số dư của bạn.

Tham số

Ví dụ

curl https://api.like360.net/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=a1b2c3d4-5e6f-7890-abcd-ef1234567890 \
  -d link=https://www.tiktok.com/@user/video/123 \
  -d quantity=1000

Phản hồi

{ "order": "LK-AB12CD" }

Gửi lại cùng một idempotency_key sẽ trả về đơn cũ thay vì tạo đơn trùng.

POST Trạng thái đơn status

Tra cứu một đơn qua order, hoặc nhiều đơn cùng lúc bằng orders (các ID cách nhau bằng dấu phẩy).

Tham số

* Dùng order cho một đơn, hoặc orders cho nhiều đơn.

Phản hồi (một đơn)

{
  "charge": "30000.0000",
  "start_count": 1200,
  "status": "In progress",
  "remains": 400,
  "currency": "VND"
}

charge = tổng tiền đã trừ cho đơn; start_count = chỉ số đếm được lúc bắt đầu chạy; remains = số lượng còn lại chưa giao.

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

{
  "LK-AB12CD": {
    "charge": "30000.0000",
    "start_count": 1200,
    "status": "Completed",
    "remains": 0,
    "currency": "VND"
  },
  "LK-KHONGCO": { "error": "Incorrect order ID" }
}

Với orders, kết quả là một object khóa theo mã đơn; đơn không tồn tại trả về error riêng cho mã đó thay vì làm hỏng cả lô.

Giá trị trạng thái

status chỉ nhận đúng 5 giá trị dưới đây - map cứng trong hệ thống, an toàn để switch-case:

Action refill và cancel sẽ được bổ sung trong bản cập nhật tới; hiện tại bảo hành bù tụt chạy tự động cho dịch vụ có refill: true, không cần gọi API.

Mã lỗi thường gặp

Ví dụ theo ngôn ngữ

Cùng một luồng (danh sách dịch vụ → tạo đơn → trạng thái) trong các ngôn ngữ phổ biến. Sao chép và thay YOUR_API_KEY.

# Danh sách dịch vụ
curl https://api.like360.net/api/v2 -d key=YOUR_API_KEY -d action=services

# Tạo đơn
curl https://api.like360.net/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=a1b2c3d4-5e6f-7890-abcd-ef1234567890 \
  -d link=https://www.tiktok.com/@user/video/123 \
  -d quantity=1000

# Trạng thái đơn
curl https://api.like360.net/api/v2 -d key=YOUR_API_KEY -d action=status -d order=LK-AB12CD

<?php
$api = new Like360Api('YOUR_API_KEY');

$services = $api->services();
$order    = $api->add([
    'service'  => 'a1b2c3d4-5e6f-7890-abcd-ef1234567890',
    'link'     => 'https://www.tiktok.com/@user/video/123',
    'quantity' => 1000,
]);
$status   = $api->status($order->order);

class Like360Api {
    private $key;
    private $url = 'https://api.like360.net/api/v2';

    public function __construct($key) { $this->key = $key; }

    public function services()     { return $this->connect(['action' => 'services']); }
    public function balance()      { return $this->connect(['action' => 'balance']); }
    public function add($params)   { return $this->connect(['action' => 'add'] + $params); }
    public function status($order) { return $this->connect(['action' => 'status', 'order' => $order]); }

    private function connect($data) {
        $data['key'] = $this->key;
        $ch = curl_init($this->url);
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_POST           => true,
            CURLOPT_POSTFIELDS     => http_build_query($data),
        ]);
        $res = curl_exec($ch);
        curl_close($ch);
        return json_decode($res);
    }
}

import requests

ENDPOINT = "https://api.like360.net/api/v2"
KEY = "YOUR_API_KEY"

def call(params):
    params["key"] = KEY
    return requests.post(ENDPOINT, data=params).json()

services = call({"action": "services"})
order = call({
    "action": "add",
    "service": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
    "link": "https://www.tiktok.com/@user/video/123",
    "quantity": 1000,
})
status = call({"action": "status", "order": order["order"]})

const ENDPOINT = "https://api.like360.net/api/v2";
const KEY = "YOUR_API_KEY";

async function call(params) {
  const body = new URLSearchParams({ ...params, key: KEY });
  const res = await fetch(ENDPOINT, { method: "POST", body });
  return res.json();
}

const services = await call({ action: "services" });
const order = await call({
  action: "add",
  service: "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
  link: "https://www.tiktok.com/@user/video/123",
  quantity: 1000,
});
const status = await call({ action: "status", order: order.order });

package main

import (
    "encoding/json"
    "net/http"
    "net/url"
)

const (
    endpoint = "https://api.like360.net/api/v2"
    apiKey   = "YOUR_API_KEY"
)

func call(params url.Values) (any, error) {
    params.Set("key", apiKey)
    resp, err := http.PostForm(endpoint, params)
    if err != nil {
        return nil, err
    }
    defer resp.Body.Close()
    var out any
    err = json.NewDecoder(resp.Body).Decode(&out)
    return out, err
}

func main() {
    call(url.Values{
        "action":   {"add"},
        "service":  {"a1b2c3d4-5e6f-7890-abcd-ef1234567890"},
        "link":     {"https://www.tiktok.com/@user/video/123"},
        "quantity": {"1000"},
    })
}