Bỏ qua menu
Đăng nhập Đăng ký

Tài liệu API

Tạo đơn nạp xu và mua kênh từ hệ thống của bạn . Mọi yêu cầu và phản hồi đều là JSON .

Xác thực

Tạo API key ở trang Hồ sơ . Gửi key ở header Authorization: Bearer nx_... hoặc X-API-Key: nx_... .

Địa chỉ gốc : https://napxu.me/api/v1

Hệ thống không có webhook . Hãy gọi lại GET /orders/{id} để xem trạng thái đơn .

Phân trang & thử lại an toàn

Các endpoint danh sách ( /orders , /channels , /channel-orders ) trả về bản ghi trong trường data , kèm current_page , per_page , total , last_page và next_page_url ( null khi hết trang ) . Chuyển trang bằng tham số ?page=2 .

Khi gặp lỗi mạng hoặc mã 504 lúc tạo đơn , hãy gửi lại đúng yêu cầu cũ với cùng client_ref : hệ thống trả về đơn đã tạo và không trừ tiền lần hai . Không bao giờ tạo client_ref mới cho một lần retry .

Mã lỗi

401
Thiếu hoặc sai API key .
403
API đang tắt cho tài khoản này , hoặc tài khoản bị khóa .
404
Không tìm thấy bản ghi , bản ghi không thuộc về bạn , hoặc phiên QR không do bạn tạo .
422
Dữ liệu không hợp lệ hoặc không thể thực hiện : số dư không đủ ( errors.balance ) , tài khoản TikTok không thuộc về bạn , máy chủ tạm ngưng , số xu sai , kênh đã bán hoặc giá vừa đổi ( errors.channel_id ) . Thông điệp chi tiết nằm trong message và errors .
429
Gọi quá nhanh . Giới hạn 120 yêu cầu mỗi phút cho mỗi tài khoản . Gọi quá nhanh nhiều lần sẽ bị chặn IP tạm thời .
502
Nhà cung cấp trả lỗi khi liên kết TikTok . Thử lại sau ít phút .
504
Nhà cung cấp không phản hồi . Với POST /orders : kiểm tra lại bằng GET /orders?status=processing hoặc gửi lại cùng client_ref , tiền không bị trừ hai lần .

Tài khoản

GET /api/v1/balance

Số dư ví chính và ví hoa hồng ( đồng ) .

curl -X GET "https://napxu.me/api/v1/balance" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json"

Phản hồi mẫu

{"balance":250000,"commission_balance":12000}

GET /api/v1/servers

Danh sách máy chủ đang bán và giá bán mỗi xu . Chỉ trả về máy chủ đang hoạt động .

curl -X GET "https://napxu.me/api/v1/servers" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json"

Phản hồi mẫu

[{"id":2,"name":"Máy chủ 1","price_per_coin":312.5,"min_buy":100,"max_buy":50000}]

GET /api/v1/tiktok-accounts

Tài khoản TikTok đã liên kết với tài khoản của bạn .

curl -X GET "https://napxu.me/api/v1/tiktok-accounts" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json"

Phản hồi mẫu

[{"id":1,"username":"tiktoker","status":"active","created_at":"2026-10-16T03:00:00.000000Z"}]

Liên kết TikTok

POST /api/v1/tiktok/qr

Tạo mã QR liên kết TikTok . Phiên QR gắn với API key của bạn và sống 15 phút .

curl -X POST "https://napxu.me/api/v1/tiktok/qr" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json"

Phản hồi mẫu

{"session_id":"...","qrcode":"data:image/png;base64,...","expire_time":180}

GET /api/v1/tiktok/qr/{sessionId}

Kiểm tra QR . Trường kind nhận waiting , challenge , done , error hoặc qr_expired . Khi done , tài khoản được tự thêm vào danh sách liên kết .

curl -X GET "https://napxu.me/api/v1/tiktok/qr/{sessionId}" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json"

Phản hồi mẫu

{"kind":"waiting"}

POST /api/v1/tiktok/qr/{sessionId}/refresh

Làm mới mã QR đã hết hạn . Chỉ dùng được với phiên do chính bạn tạo , nếu không trả 404 .

curl -X POST "https://napxu.me/api/v1/tiktok/qr/{sessionId}/refresh" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json"

Phản hồi mẫu

{"session_id":"...","qrcode":"...","expire_time":180}

POST /api/v1/tiktok/challenge

Xác minh đăng nhập . action = choose ( kèm method ) hoặc submit ( kèm value , tối đa 64 ký tự ) .

curl -X POST "https://napxu.me/api/v1/tiktok/challenge" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json" \
  -H "Content-Type: application/json" -d '{"session_id":"...","action":"submit","value":"123456"}'

Phản hồi mẫu

{"kind":"done","account":{"id":"...","tiktok_username":"tiktoker"}}

POST /api/v1/tiktok/cookie

Liên kết bằng cookie TikTok ( tối đa 20 000 ký tự ) .

curl -X POST "https://napxu.me/api/v1/tiktok/cookie" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json" \
  -H "Content-Type: application/json" -d '{"cookie":"..."}'

Phản hồi mẫu

{"kind":"done"}

Đơn nạp xu

POST /api/v1/orders

Tạo đơn xu và trừ tiền ví ngay . client_ref là mã do bạn tự đặt ( tối đa 64 ký tự , duy nhất theo tài khoản ) : gửi lại cùng client_ref sẽ trả về đơn cũ và KHÔNG trừ tiền lần hai , vì vậy hãy luôn gửi kèm và dùng lại khi retry . Số xu là bội số của 100 , trong khoảng min_buy – max_buy của máy chủ .

curl -X POST "https://napxu.me/api/v1/orders" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json" \
  -H "Content-Type: application/json" -d '{"tiktok_account_id":1,"server_id":2,"coins":1000,"client_ref":"don-0001"}'

Phản hồi mẫu

{"id":120,"status":"processing","tiktok_account_id":1,"server_id":2,"coins":1000,"total":312500,"client_ref":"don-0001","fail_reason":null,"created_at":"...","completed_at":null}

GET /api/v1/orders?status=processing&page=1

Danh sách đơn xu , mới nhất trước , 50 đơn mỗi trang . Lọc theo status : processing , completed , failed . Kết quả nằm trong trường data ( xem mục Phân trang ) .

curl -X GET "https://napxu.me/api/v1/orders?status=processing&page=1" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json"

Phản hồi mẫu

{"current_page":1,"data":[{"id":120,"status":"completed","coins":1000,"total":312500,"client_ref":"don-0001"}],"per_page":50,"total":1,"last_page":1,"next_page_url":null}

GET /api/v1/orders/{id}

Chi tiết một đơn xu . status : processing ( đang nạp ) , completed ( xu đã vào ) hoặc failed ( thất bại , tiền đã hoàn vào ví , lý do ở fail_reason ) .

curl -X GET "https://napxu.me/api/v1/orders/{id}" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json"

Phản hồi mẫu

{"id":120,"status":"failed","coins":1000,"total":312500,"fail_reason":"Nhà cung cấp từ chối: ...","completed_at":null}

Kênh TikTok

GET /api/v1/channels?niche=&q=&min_followers=&max_followers=&min_price=&max_price=&page=1

Danh sách kênh đang bán , nhiều follower trước , 50 kênh mỗi trang . Mọi tham số lọc đều tùy chọn .

curl -X GET "https://napxu.me/api/v1/channels?niche=&q=&min_followers=&max_followers=&min_price=&max_price=&page=1" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json"

Phản hồi mẫu

{"current_page":1,"data":[{"id":5,"title":"Kênh review","niche":"review","follower_count":120000,"like_count":2500000,"price":550000,"masked_username":"re***ew","thumbnail_url":"https://..."}],"per_page":50,"total":1}

GET /api/v1/channels/{id}

Chi tiết một kênh . Trả 404 nếu kênh không tồn tại hoặc đã bán .

curl -X GET "https://napxu.me/api/v1/channels/{id}" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json"

Phản hồi mẫu

{"id":5,"title":"Kênh review","description":"...","niche":"review","follower_count":120000,"like_count":2500000,"price":550000,"masked_username":"re***ew","thumbnail_url":"https://...","photos":[]}

POST /api/v1/channels/{id}/buy

Mua kênh và trừ tiền ví ngay . expected_price phải bằng giá hiện tại ( lấy từ GET /channels/{id} ) ; nếu giá vừa đổi hoặc kênh vừa được bán , trả 422 với lỗi ở errors.channel_id . client_ref hoạt động như ở đơn xu .

curl -X POST "https://napxu.me/api/v1/channels/{id}/buy" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json" \
  -H "Content-Type: application/json" -d '{"expected_price":550000,"client_ref":"kenh-0001"}'

Phản hồi mẫu

{"id":31,"status":"processing","channel_id":5,"price":550000,"client_ref":"kenh-0001","fail_reason":null,"created_at":"...","completed_at":null,"credentials":null}

GET /api/v1/channel-orders?page=1

Đơn kênh , mới nhất trước , 50 đơn mỗi trang , nằm trong trường data .

curl -X GET "https://napxu.me/api/v1/channel-orders?page=1" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json"

Phản hồi mẫu

{"current_page":1,"data":[{"id":31,"status":"completed","channel_id":5,"price":550000,"credentials":{"username":"...","password":"...","email":"...","twoFactor":"..."}}],"per_page":50,"total":1}

GET /api/v1/channel-orders/{id}

Chi tiết một đơn kênh . credentials là null khi đang xử lý và chỉ có đầy đủ ( username , password , email , twoFactor ... tùy kênh ) khi status = completed .

curl -X GET "https://napxu.me/api/v1/channel-orders/{id}" \
  -H "Authorization: Bearer nx_..." -H "Accept: application/json"

Phản hồi mẫu

{"id":31,"status":"completed","channel_id":5,"price":550000,"client_ref":"kenh-0001","fail_reason":null,"completed_at":"...","credentials":{"username":"...","password":"..."}}