Site 2
Đăng nhập

Tài liệu API

Mọi API của Site 2 ở một trang. Tool chạy nick của bạn nhận việc theo từng nick, làm xong báo kết quả để được cộng coin.

API làm việc — cho tool chạy nick

Ba việc tool cần làm: lấy token, nhận việc cho một nick, báo kết quả. Mỗi việc làm xong và được duyệt thì cộng coin.

Bắt đầu nhanh: 3 bước

  1. Lấy token

    Tạo token ở trang Token rồi gửi kèm mọi yêu cầu trong header. Mở trang Token

    Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

  2. Nhận việc

    Gửi mã nick, loại việc muốn làm và mạng xã hội; nhận về một việc kèm job_id, link cần tương tác và tiền thưởng.

    POST https://site2.traodoituongtac.com/api/tasks/get
{
    "account": "100012345678901",
    "kinds": [
        "like",
        "follow"
    ],
    "network": "facebook"
}
    {
    "ok": true,
    "tasks": [
        {
            "job_id": "6720f1c3a9e4b2d815c7a3f0",
            "reward": 5,
            "target": "https://www.facebook.com/100012345678902/posts/1",
            "detail": "",
            "kind": "like",
            "network": "facebook"
        }
    ]
}

  3. Báo kết quả

    Làm xong gửi lại đúng job_id với success true/false; được duyệt thì cộng coin.

    POST https://site2.traodoituongtac.com/api/tasks/report
{
    "job_id": "6720f1c3a9e4b2d815c7a3f0",
    "success": true,
    "dead": false
}
    {
    "ok": true
}
Hạn làm mỗi việc: 10 phút, theo cài đặt site. Khi ok là false: đọc error, chờ retry_in giây rồi gọi lại (EMPTY = tạm hết việc cho nick đó).
Địa chỉ gốc
https://site2.traodoituongtac.com/api
Xác thực
Authorization: Bearer YOUR_TOKEN
Dữ liệu gửi
JSON (Content-Type: application/json)
Phản hồi
JSON; luôn có ok (true/false), lỗi kèm error và retry_in (giây nên chờ trước khi gọi lại)

Mọi yêu cầu gửi header Authorization: Bearer kèm token tool của tài khoản bạn. Tạo hoặc đổi token ở trang Token. Mở trang Token

Giữ kín token: ai có token đều nhận việc và báo kết quả thay bạn. Tạo token mới thì token cũ hết dùng được. Token này cũng là khoá SMM API — ai có nó có thể đặt đơn bằng số dư của bạn; chỉ dán vào công cụ bạn tin.

Token sai, thiếu hoặc không thuộc site này (HTTP 401) — tài khoản bị khoá nhận việc trả ACCOUNT_LOCKED, không phải lỗi này

{
    "ok": false,
    "error": "DENIED"
}

POSTNhận việc

https://site2.traodoituongtac.com/api/tasks/get

Xin một việc cho một nick. Mỗi lần gọi trả một việc; làm xong báo kết quả trước hạn.

Tham sốKiểuMô tả
account string Bắt buộc · Mã nick làm việc (gửi dạng chuỗi — mã dài gửi dạng số sẽ mất chữ số)
kinds string[] Bắt buộc · Danh sách loại việc muốn nhận (xem bảng Loại việc bên dưới)
network string Bắt buộc · Mạng xã hội của nick: facebook hoặc tiktok

Ví dụ yêu cầu

{
    "account": "100012345678901",
    "kinds": [
        "like",
        "follow"
    ],
    "network": "facebook"
}

Ví dụ phản hồi

{
    "ok": true,
    "tasks": [
        {
            "job_id": "6720f1c3a9e4b2d815c7a3f0",
            "reward": 5,
            "target": "https://www.facebook.com/100012345678902/posts/1",
            "detail": "",
            "kind": "like",
            "network": "facebook"
        }
    ]
}

Ví dụ khi không thành công

{
    "ok": false,
    "error": "EMPTY",
    "retry_in": 15
}

Các trường của một việc (tasks[])

job_idstringMã việc: dùng nguyên văn khi báo kết quả (không tự tạo, không sửa)
rewardnumberSố coin nhận được khi việc được duyệt
targetstringLink hoặc đối tượng cần tương tác
detailstring | objectNội dung kèm theo (VD nội dung bình luận); rỗng nếu không cần
kindstringLoại việc
networkstringMạng xã hội

POSTBáo kết quả

https://site2.traodoituongtac.com/api/tasks/report

Báo kết quả một việc đã nhận, chỉ cần gửi job_id của việc đó.

Tham sốKiểuMô tả
job_id string Bắt buộc · Mã việc (job_id) nhận được khi lấy việc — dùng nguyên văn khi báo kết quả (gửi dạng chuỗi)
success bool Bắt buộc · true nếu đã làm xong, false nếu không làm được
dead bool Tuỳ chọn · true nếu bài/đối tượng không còn (đã xoá, không mở được) — mặc định false

Ví dụ yêu cầu

{
    "job_id": "6720f1c3a9e4b2d815c7a3f0",
    "success": true,
    "dead": false
}

Ví dụ phản hồi

{
    "ok": true
}

Ví dụ khi không thành công

{
    "ok": false,
    "error": "EXPIRED",
    "retry_in": 0
}

GETThông tin tài khoản

https://site2.traodoituongtac.com/api/me

Kiểm tra token và xem số dư coin hiện tại (đọc thẳng từ tài khoản, không trễ).

Ví dụ yêu cầu

curl -H "Authorization: Bearer YOUR_TOKEN" https://site2.traodoituongtac.com/api/me

Ví dụ phản hồi

{
    "ok": true,
    "account": {
        "username": "nguoilam01",
        "balance": 12850,
        "currency": "COIN"
    }
}

Loại việc

Giá trị dùng cho kinds khi nhận việc, theo từng mạng xã hội.

Site chưa mở loại việc nào.

Mã lỗi

Khi ok là false, đọc error để biết lý do và retry_in để biết nên chờ bao lâu (0 = gọi lại cũng không được).

errorHTTPretry_inÝ nghĩa
EMPTY20015Tạm hết việc cho nick này, thử lại sau
WAIT20030Gọi quá nhanh hoặc nick đang được kiểm tra — chờ rồi thử lại
ACCOUNT_INVALID2000Nick không dùng được (chưa thêm vào tài khoản, sai mã hoặc nick hỏng) — đổi nick khác
ACCOUNT_LOCKED2000Tài khoản bị khoá nhận việc — liên hệ hỗ trợ (thông tin tài khoản vẫn xem được)
DENIED401—Token sai, thiếu hoặc tài khoản không dùng được ở site này
BUSY50360Hệ thống đang bận — thử lại sau
BAD_REQUEST422—Thiếu tham số, sai kiểu, hoặc thông tin báo kết quả không khớp việc đã nhận
EXPIRED2000Việc đã đóng (đã báo trước đó hoặc quá hạn) — không báo lại được