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
Token của bạn
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ộ.
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).
{ "ok": true, "data": { … } }{ "ok": false,
"error": { "code": "INSUFFICIENT_POINTS", "message": "…" } }| HTTP | code | Ý nghĩa |
|---|---|---|
| 400 | INVALID_REQUEST | Tham số thiếu hoặc không hợp lệ. Chưa trừ điểm. |
| 401 | UNAUTHORIZED | Thiếu token, token sai hoặc đã thu hồi. |
| 402 | INSUFFICIENT_POINTS | Ví không đủ điểm. Chưa tạo đơn. |
| 403 | ACCOUNT_RESTRICTED | Tài khoản đang bị khóa. |
| 404 | NOT_FOUND | Không tìm thấy đơn, dự án hoặc endpoint. |
| 409 | CONFLICT | Dịch vụ hết suất cho dự án này. |
| 429 | RATE_LIMITED | Quá 300 yêu cầu mỗi phút, hoặc quá 60 đơn mỗi phút. Chờ theo header Retry-After. |
| 500 | SERVER_ERROR | Lỗ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 -sS 'https://backlink2top.com/api/v1/balance' \
-H "Authorization: Bearer $TOKEN"{ "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ểu | Bắt buộc | Mô tả |
|---|---|---|---|
| project_id | integer | Không | ID dự án. Khi có, max là số lượng dự án đó còn đặt được. |
curl -sS 'https://backlink2top.com/api/v1/services' \
-H "Authorization: Bearer $TOKEN"{ "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 -sS 'https://backlink2top.com/api/v1/projects' \
-H "Authorization: Bearer $TOKEN"{ "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ểu | Bắt buộc | Mô tả |
|---|---|---|---|
| service | string | Có | entity · blog_comment · google_stacking · social · podcast · chrome · firefox |
| quantity | integer | Không | Bắt buộc với entity, blog_comment, google_stacking. Với chrome và firefox luôn là 1. |
| project_id | integer | Không | Dự án có sẵn. |
| project | object | Không | Dự án mới: { name, website }. Bắt buộc khi không gửi project_id. |
| targets | array | Không | Bắt buộc với social và podcast: danh sách { url, keyword } thuộc website của dự án. |
| posts_per_article | integer | Không | Chỉ 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. |
| topics | array | Không | Chỉ 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). |
| coupon | string | Không | Mã giảm giá. |
| order_ref | string | Không | Mã tham chiếu của bạn, tối đa 64 ký tự, dùng để chống tạo trùng. |
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" } }'{ "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 -sS 'https://backlink2top.com/api/v1/orders/B2T-234BA03F15' \
-H "Authorization: Bearer $TOKEN"{ "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ểu | Bắt buộc | Mô tả |
|---|---|---|---|
| status | string | Không | pending · running · completed · partial · refunded · cancelled |
| service | string | Không | Lọc theo dịch vụ. |
| page | integer | Không | Mặc định 1. |
| limit | integer | Không | Mặc định 20, tối đa 100. |
curl -sS 'https://backlink2top.com/api/v1/orders' \
-H "Authorization: Bearer $TOKEN"{ "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 -sS -X POST 'https://backlink2top.com/api/v1/orders/B2T-234BA03F15/cancel' \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' \
-d '{}'{ "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. |
| partial | Giao một phần; phần còn lại đã hoàn điểm. |
| refunded | Không giao được; đã hoàn toàn bộ điểm. |
| cancelled | Bạ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.