REST · JSON

Tài liệu API

API cho đại lý và hệ thống tự động: đặt đơn backlink, theo dõi tiến độ và lấy link kết quả. Mọi thao tác dùng chung ví điểm và giá với bảng điều khiển.

Địa chỉ gốc

https://backlink2top.com/api/v1

Xác thực

Gửi token trong header Authorization ở mọi yêu cầu. Chỉ dùng HTTPS. Token có quyền tiêu điểm trong ví, nên hãy giữ kín và thu hồi ngay nếu bị lộ.

Header
Authorization: Bearer b2t_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Định dạng & lỗi

Thành công trả về ok = true và dữ liệu trong data. Lỗi trả về ok = false kèm mã lỗi cho máy đọc và câu mô tả. Câu mô tả theo ngôn ngữ của header Accept-Language (vi hoặc en).

200
{ "ok": true, "data": { … } }
4xx / 5xx
{ "ok": false,
  "error": { "code": "INSUFFICIENT_POINTS", "message": "…" } }
HTTPcodeÝ nghĩa
400INVALID_REQUESTTham số thiếu hoặc không hợp lệ. Chưa trừ điểm.
401UNAUTHORIZEDThiếu token, token sai hoặc đã thu hồi.
402INSUFFICIENT_POINTSVí không đủ điểm. Chưa tạo đơn.
403ACCOUNT_RESTRICTEDTài khoản đang bị khóa.
404NOT_FOUNDKhông tìm thấy đơn, dự án hoặc endpoint.
409CONFLICTDịch vụ hết suất cho dự án này.
429RATE_LIMITEDQuá 300 yêu cầu mỗi phút, hoặc quá 60 đơn mỗi phút. Chờ theo header Retry-After.
500SERVER_ERRORLỗi phía máy chủ. Kiểm tra đơn bằng order_ref trước khi gửi lại.

Khi mạng timeout lúc tạo đơn, đừng gửi lại mù quáng: gửi lại đúng order_ref cũ. Nếu đơn đã được tạo, bạn nhận lại chính đơn đó với duplicate = true và không bị trừ điểm lần hai.

Xem số dư

GET/api/v1/balance

Số điểm hiện có trong ví.

cURL
curl -sS 'https://backlink2top.com/api/v1/balance' \
  -H "Authorization: Bearer $TOKEN"
Phản hồi mẫu
{ "ok": true, "data": { "points": 18700 } }

Danh sách dịch vụ

GET/api/v1/services

Giá, số lượng tối thiểu và tối đa của từng loại backlink. Thêm project_id để nhận giới hạn riêng của một dự án.

Tham sốKiểuBắt buộcMô tả
project_idintegerKhôngID dự án. Khi có, max là số lượng dự án đó còn đặt được.
cURL
curl -sS 'https://backlink2top.com/api/v1/services' \
  -H "Authorization: Bearer $TOKEN"
Phản hồi mẫu
{ "ok": true, "data": {
  "services": [
    { "key": "entity", "name": "Entity", "unit": "link", "price": 30, "min": 10, "max": 500,
      "available": true, "hands_over_accounts": true, "warranty_days": 30 }
  ],
  "project": null
} }

Danh sách dự án

GET/api/v1/projects

Mỗi dự án là một website. Dự án được tạo khi bạn đặt đơn đầu tiên cho website đó.

cURL
curl -sS 'https://backlink2top.com/api/v1/projects' \
  -H "Authorization: Bearer $TOKEN"
Phản hồi mẫu
{ "ok": true, "data": { "projects": [ { "id": 1, "name": "An Nhien", "website": "https://annhien.example.com", "created_at": "2026-11-16T10:37:00.000Z" } ] } }

Tạo đơn hàng

POST/api/v1/orders

Trừ điểm ngay và tiếp nhận đơn. Gửi project_id cho dự án có sẵn, hoặc project để tạo dự án mới. Gửi cùng order_ref lần nữa sẽ trả về đơn đã tạo, không tạo đơn thứ hai.

Tham sốKiểuBắt buộcMô tả
servicestringCóentity · blog_comment · google_stacking · social · podcast · chrome · firefox
quantityintegerKhôngBắt buộc với entity, blog_comment, google_stacking. Với chrome và firefox luôn là 1.
project_idintegerKhôngDự án có sẵn.
projectobjectKhôngDự án mới: { name, website }. Bắt buộc khi không gửi project_id.
targetsarrayKhôngBắt buộc với social và podcast: danh sách { url, keyword } thuộc website của dự án.
posts_per_articleintegerKhôngChỉ với social: số bài đăng cho mỗi bài viết. Số lượng của đơn = số bài viết × giá trị này.
topicsarrayKhôngChỉ với entity: giới hạn nhóm chủ đề nền tảng. Khi gửi tham số này, giá mỗi link cộng phụ phí chọn nhóm (xem GET /services).
couponstringKhôngMã giảm giá.
order_refstringKhôngMã tham chiếu của bạn, tối đa 64 ký tự, dùng để chống tạo trùng.
cURL
curl -sS -X POST 'https://backlink2top.com/api/v1/orders' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ "service": "entity", "quantity": 50, "order_ref": "crm-1042", "project": { "name": "An Nhien", "website": "annhien.example.com" } }'
Phản hồi mẫu
{ "ok": true, "data": { "duplicate": false, "order": {
  "code": "B2T-234BA03F15", "order_ref": "crm-1042", "service": "entity", "status": "pending",
  "quantity": 50, "delivered": 0, "unit_price": 30, "total": 1500, "refunded": 0,
  "project": { "id": 1, "name": "An Nhien", "website": "https://annhien.example.com" },
  "links": [], "extra_pages": [], "can_cancel": true, "hands_over_accounts": true
} } }

Xem đơn hàng

GET/api/v1/orders/{code}

Trạng thái, tiến độ và các link đã hoàn thành. Gọi lại định kỳ để theo dõi; link xuất hiện dần khi đơn đang chạy.

cURL
curl -sS 'https://backlink2top.com/api/v1/orders/B2T-234BA03F15' \
  -H "Authorization: Bearer $TOKEN"
Phản hồi mẫu
{ "ok": true, "data": { "order": {
  "code": "B2T-234BA03F15", "status": "partial", "quantity": 50, "delivered": 47, "total": 1500, "refunded": 90,
  "notice": "…",
  "links": [ { "url": "https://…", "site": "…", "completed_at": "2026-11-17T02:11:09.000Z" } ],
  "extra_pages": []
} } }

Danh sách đơn hàng

GET/api/v1/orders

Đơn mới nhất trước. Danh sách không kèm link; đọc link ở từng đơn.

Tham sốKiểuBắt buộcMô tả
statusstringKhôngpending · running · completed · partial · refunded · cancelled
servicestringKhôngLọc theo dịch vụ.
pageintegerKhôngMặc định 1.
limitintegerKhôngMặc định 20, tối đa 100.
cURL
curl -sS 'https://backlink2top.com/api/v1/orders' \
  -H "Authorization: Bearer $TOKEN"
Phản hồi mẫu
{ "ok": true, "data": { "orders": [ { "code": "B2T-234BA03F15", "service": "entity", "status": "running", "quantity": 50, "delivered": 12, "total": 1500, "refunded": 0 } ], "page": 1, "limit": 20, "total": 1 } }

Hủy đơn hàng

POST/api/v1/orders/{code}/cancel

Chỉ hủy được đơn còn ở trạng thái pending. Toàn bộ điểm được hoàn về ví.

cURL
curl -sS -X POST 'https://backlink2top.com/api/v1/orders/B2T-234BA03F15/cancel' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'
Phản hồi mẫu
{ "ok": true, "data": { "order": { "code": "B2T-234BA03F15", "status": "cancelled", "refunded": 1500 } } }

Trạng thái đơn

pendingĐã tiếp nhận, đang chuẩn bị. Hủy được.
runningĐang thực hiện. Link xuất hiện dần.
completedĐã giao đủ số lượng.
partialGiao một phần; phần còn lại đã hoàn điểm.
refundedKhông giao được; đã hoàn toàn bộ điểm.
cancelledBạn đã hủy; đã hoàn toàn bộ điểm.

Tài khoản bàn giao của đơn Entity chỉ xem được trong bảng điều khiển, sau khi xác nhận mật khẩu; API không trả về mật khẩu tài khoản.

Tài liệu API · Backlink2Top