Tài liệu API | Công Nghệ 247

Xác thực

Mỗi tài khoản có một API Key riêng. Gửi key trong mọi request qua trường key.

Đăng nhập hoặc đăng ký để lấy API Key. Tài liệu bên dưới xem được công khai.

Endpoint & định dạng

URL:

https://congnghe247.vn/api/reseller_api.php

Method: POST
Header: Content-Type: application/json
Body: JSON object với key, action và tham số tương ứng
Response: JSON — trường success (boolean) khi có

curl -X POST "https://congnghe247.vn/api/reseller_api.php" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "API_KEY_CUA_BAN",
    "action": "balance"
  }'

Dịch vụ MXH

POST services Danh sách dịch vụ MXH

Tham số	Bắt buộc	Mô tả
`key`	Có	API Key
`action`	Có	`services`

{
  "key": "API_KEY_CUA_BAN",
  "action": "services"
}

POST add Tạo đơn MXH

Tham số	Bắt buộc	Mô tả
`service`	Có	ID dịch vụ (từ `services`)
`link`	Có	Link bài viết / kênh
`quantity`	Có	Số lượng
`comments`	Không	Nội dung comment (mỗi dòng 1 comment)
`reaction`	Không	like, love, care, haha, sad, angry

{
  "key": "API_KEY_CUA_BAN",
  "action": "add",
  "service": 123,
  "link": "https://facebook.com/post/...",
  "quantity": 100
}

POST status Trạng thái đơn MXH

order Có ID đơn hàng

{
  "key": "API_KEY_CUA_BAN",
  "action": "status",
  "order": 456
}

POST balance Số dư ví

{
  "key": "API_KEY_CUA_BAN",
  "action": "balance"
}

{
  "success": true,
  "balance": 1500000,
  "currency": "VND"
}

Thuê số OTP

API thuê số và nhận mã OTP. Không lộ nhà cung cấp phía sau cho người dùng cuối.

POST sms_services Danh sách dịch vụ thuê số

country Không vn (mặc định) hoặc la

{
  "key": "API_KEY_CUA_BAN",
  "action": "sms_services",
  "country": "vn"
}

POST sms_rent Thuê số

`service_id`	Có	ID từ sms_services
`country`	Không	`vn` / `la`

{
  "key": "API_KEY_CUA_BAN",
  "action": "sms_rent",
  "service_id": "4",
  "country": "vn"
}

POST sms_otp Lấy mã OTP

order_id Có ID đơn từ sms_rent

{
  "key": "API_KEY_CUA_BAN",
  "action": "sms_otp",
  "order_id": 789
}

Mã lỗi HTTP

HTTP	Ý nghĩa
`400`	Thiếu hoặc sai tham số
`403`	API Key không hợp lệ
`402`	Số dư ví không đủ
`404`	Không tìm thấy đơn / dịch vụ
`502`	Lỗi tạm thời phía hệ thống

Best practices

Gọi API từ backend của bạn — không để lộ API Key trên trình duyệt người dùng.
Bạn có thể markup giá trên website riêng; mọi đơn trừ tiền từ ví tài khoản Công Nghệ 247.
Kiểm tra balance trước khi tạo đơn hàng loạt.
Lưu order_id để tra cứu trạng thái và OTP.
Liên hệ hỗ trợ nếu cần tăng hạn mức hoặc webhook (tính năng tùy chỉnh).