Hướng Dẫn Sử Dụng API v1


+ Lấy token tại https://proxy.mkvn.net/Auth/Profile
+ Chỉ PARTNER mới được sử dụng api, Bạn cần liên hệ với admin Jenny để thiết lập PARTNER.
+ Các bạn đấu api về web có thể tự quyết định hoàn toàn giá đầu ra.

Bạn cần đăng nhập để xem thông tin này.


HỆ THỐNG CẤP PARTNER:
+ Ngày 01 hàng tháng, hệ thống sẽ tự kiểm tra xem tháng trước bạn PARTNER nạp bao nhiêu tiền, từ đó căn cứ để quyết định cấp độ cho bạn trong tháng.

+ Ví dụ:
- tháng 8 vừa rồi bạn partner A nạp 10,1 triệu, thì ngày 01/9 hệ thống sẽ cho bạn thành cấp PARTNER10 (hưởng 10% chiết khấu).
- nhưng nguyên tháng 9 bạn partner A bán ít lại, chỉ nạp 5,1 triệu, thì đến ngày 01/10 hệ thống tự kiểm tra và thiết lập lại cấp thành PARTNER5 (hưởng 5% chiết khấu).
- Do vậy nên cấp PARTNER của bạn có thể thay đổi theo thời gian, đầu tháng ngày 01 hệ thống sẽ tính 1 lần, trong nguyên tháng đó sẽ không thay đổi.

Bảng Thống Kê Chiết Khấu

CẤP CHIẾT KHẤU % ĐIỀU KIỆN NẠP TIỀN THÁNG TRƯỚC
PARTNER0 0% Nạp tiền từ 0 đ đến 5 triệu
PARTNER5 5% Nạp tiền từ 5 triệu đến 10 triệu
PARTNER10 10% Nạp tiền từ 10 triệu đến 15 triệu
PARTNER15 15% Nạp tiền từ 15 triệu đến 20 triệu
PARTNER20 20% Nạp tiền từ 20 triệu đến 25 triệu
PARTNER25 25% Nạp tiền từ 25 triệu đến 30 triệu
PARTNER30 30% Nạp tiền trên 30 triệu

#Get Balance (Xem số dư)

Method: GET

URL: https://proxy.mkvn.net/api/apiv1/getbalance.php?token=xxxyyyzzz

Dữ liệu đầu vào: token (bắt buộc)

Kết quả:

{
  "status": "SUCCESS",
  "statusCode": 200,
  "username": "usera",
  "balance": 81000
}

#Get Products (thông tin toàn bộ sản phẩm, hàng tồn kho)

Method: GET

URL: https://proxy.mkvn.net/api/apiv1/products.php

Kết quả:

{
  "status": "SUCCESS",
  "statusCode": 200,
  "data": [
    {
      "id_product": "271",
      "name_product": "(SP0) - GÓI 10 PROXY IPV6 - FREE",
      "price": "10000000",
      "type": "IPV6",
      "countrycode": "vn",
      "description": "GÓI FREE 1 THÁNG, VUI LÒNG VÀO NHÓM ZALO NHẬN (KHÔNG MUA)",
      "buy_max": "1000",
      "buy_min": null,
      "store_quantity": 20
    }]
}

#Get List Orders

Method: GET

URL: https://proxy.mkvn.net/api/apiv1/getlistorders.php?token=xxxyyyzzz

Dữ liệu đầu vào: token (bắt buộc)

Kết quả:

{
  "status": "SUCCESS",
  "statusCode": 200,
  "total_orders": 25,
  "status_summary": {
    "ON": 0,
    "OFF": 20,
    "EXPIRE": 5
  },
  "data": [
    {
      "username": "usera",
      "code": "010924C4AE66BF2013",
      "name_product": "(SP01) - HÀ NỘI - GÓI 1 PROXY IPV6 - FACEBOOK",
      "quantity": 2,
      "price": 2080,
      "time_buy": "2024-09-01 18:10:44",
      "time_dau_ky": "2025-12-01",
      "time_cuoi_ky": "2025-12-31",
      "time_con_lai": 485,
      "renewal": "OFF",
      "note": null,
      "type": "IPV6"
    }]
}

#Proxies (lấy proxy từ đơn hàng)

Method: GET

URL: https://proxy.mkvn.net/api/apiv1/proxies.php?token=xxxyyyzzz&ordercode=020924EA8A022B82C5

Dữ liệu đầu vào: token (bắt buộc), ordercode (bắt buộc)

Kết quả:

{
  "status": "SUCCESS",
  "statusCode": 200,
  "message": "Truy vấn thành công!",
  "order_code": "020924EA8A022B82C5",
  "proxies": [
    "hanoi108.proxy.mkvn.net:10378:FS3pG:12345",
    "hanoi108.proxy.mkvn.net:10379:l2wCW:12345"
  ],
  "proxiesip": [
    "103.89.142.95:10378:FS3pG:12345",
    "103.89.142.95:10379:l2wCW:12345"
  ]
}

#Buy (mua)

Method: POST

URL: https://proxy.mkvn.net/api/apiv1/buy.php?id_product=15&quantity=2&renewal=OFF&token=xxxyyyzzz

Dữ liệu đầu vào: token (bắt buộc), id_product (bắt buộc), quantity (bắt buộc), renewal (tùy chọn, mặc định "ON")

Kết quả:

{
  "status": "SUCCESS",
  "statusCode": 200,
  "message": "Giao dịch thành công!",
  "order_code": "020924EA8A022B82C5",
  "name_product": "(SP01) - HÀ NỘI - GÓI 1 PROXY IPV6 - FACEBOOK",
  "id_product": 15,
  "value_order": 2080,
  "renewal": "OFF",
  "quantity": 2,
  "proxies": [
    "hanoi108.proxy.mkvn.net:10378:FS3pG:12345",
    "hanoi108.proxy.mkvn.net:10379:l2wCW:12345"
  ],
  "proxiesip": [
    "103.89.142.95:10378:FS3pG:12345",
    "103.89.142.95:10379:l2wCW:12345"
  ],
  "timeday": "02-09-2024 09:44:44",
  "timestamp": 1725245084
}

#Renewal Plus (Cộng Tháng)

Method: POST

URL: https://proxy.mkvn.net/api/apiv1/renewalplus.php?token=xxxyyyzzz&ordercode=020924EA8A022B82C5&month=1

Dữ liệu đầu vào: token (bắt buộc), ordercode (bắt buộc), month (bắt buộc)

Kết quả:

{
  "status": "SUCCESS",
  "statusCode": 200,
  "message": "Gia hạn thành công!",
  "order_code": "020924EA8A022B82C5",
  "new_expiry_time": "02-10-2024",
  "remaining_balance": 3985440
}

#Renewal On/Off (Bật/Tắt Gia Hạn Theo Đơn)

Method: POST

URL: https://proxy.mkvn.net/api/apiv1/renewalonoff.php?token=xxxyyyzzz&ordercode=020924EA8A022B82C5&renewal=off

Dữ liệu đầu vào: token (bắt buộc), ordercode (bắt buộc), renewal (bắt buộc) on hoặc off

Kết quả:

{
  "status": "SUCCESS",
  "statusCode": 200,
  "message": "Cập nhật trạng thái gia hạn thành công.",
  "order_code": "020924EA8A022B82C5",
  "renewal": "OFF"
}

#Renewal On/Off All (Bật/Tắt Gia Hạn Toàn Bộ)

Method: POST

URL: https://proxy.mkvn.net/api/apiv1/renewalonoffall.php?token=xxxyyyzzz&renewalall=off

Dữ liệu đầu vào: token (bắt buộc), renewalall (bắt buộc) on hoặc off

Kết quả:

{
  "status": "SUCCESS",
  "statusCode": 200,
  "message": "Cập nhật trạng thái gia hạn thành công cho các đơn hàng.",
  "renewalall": "OFF",
  "updated_orders": [
    "2706240XNTA7EH43WD",
    "010924560AE12F1AD3",
    "01092415F6BE9208D0",
    "010924BA76FBD8B25E",
    "0109242AB8881E1163",
    "0109248DB67EEF4BCE",
    "010924E025F319B197"
  ]
}

#DNS domain (tra ip domain)

Method: GET

URL: https://proxy.mkvn.net/api/apiv1/domaindns.php

Kết quả:

{
  "status": "SUCCESS",
  "statusCode": 200,
  "total": 375,
  "data": [
    {
      "id": 3,
      "subdomain": "germany101.proxy.mkvn.net",
      "ip": "159.69.206.146",
      "timeupdate": "2024-09-02 14:17:54"
    }
    ]
}

#Socks5 (list)

Method: GET

URL: https://proxy.mkvn.net/api/apiv1/socks5list.php?token=xxxyyyzzz

Dữ liệu đầu vào: token (bắt buộc)

Kết quả:

{
  "status": "SUCCESS",
  "statusCode": 200,
  "message": "Truy vấn thành công!",
  "data": [
    {
      "order_code": "020924EA8A022B82C5",
      "proxyhttp": "hanoi109.proxy.mkvn.net:10373:kRQfl:456789",
      "proxynatsocks5": "socks5-01.proxy.mkvn.net:41287:socks53221881:12345",
      "proxiesipsocks5": "15.161.29.217:41287:socks53221881:12345",
      "timeadd": "2024-09-03 17:06:28"
    }
    ]
}

#Socks5 (add)

Method: POST

URL: https://proxy.mkvn.net/api/apiv1/socks5add.php?token=xxxyyyzzz&ordercode=020924EA8A022B82C5

Dữ liệu đầu vào: token (bắt buộc), ordercode (bắt buộc)

Kết quả:

{
  "status": "SUCCESS",
  "statusCode": 200,
  "message": "Xử lý thành công!",
  "order_code": "020924EA8A022B82C5",
  "data": [
    {
      "proxyhttp": "hanoi109.proxy.mkvn.net:10373:kRQfl:456789",
      "proxynatsocks5": "socks5-01.proxy.mkvn.net:41287:socks53221881:12345",
      "proxiesipsocks5": "15.161.29.217:41287:socks53221881:12345"
    }
    ]
}

#Ủy quyền ip:port (list)

Method: GET

URL: https://proxy.mkvn.net/api/apiv1/uyquyenlist.php?token=xxxyyyzzz

Dữ liệu đầu vào: token (bắt buộc)

Kết quả:

{
  "status": "SUCCESS",
  "statusCode": 200,
  "message": "Truy vấn thành công.",
  "data": [
    {
      "order_code": "020924EA8A022B82C5",
      "proxygochttp": "hanoi109.proxy.mkvn.net:10373:kRQfl:456789",
      "proxyuyquyen": "uqserver01.proxy.mkvn.net:41823",
      "proxyuyquyenip": "14.225.207.32:44255",
      "iplocal": "15.161.29.217",
      "server": "01",
      "timeupdate": "2024-09-04 15:07:19"
    }
    ]
}

#Ủy quyền ip:port (add)

Method: POST

URL: https://proxy.mkvn.net/api/apiv1/uyquyenadd.php?token=xxxyyyzzz&ordercode=020924EA8A022B82C5&ipinput=15.162.21.215

Dữ liệu đầu vào: token (bắt buộc), ordercode (bắt buộc), ipinput (bắt buộc)

Kết quả:

{
  "status": "SUCCESS",
  "statusCode": 200,
  "message": "Thêm mới cấu hình ủy quyền proxy thành công!",
  "order_code": "020924EA8A022B82C5",
  "iplocal": "15.162.21.215",
  "data": [
    {
      "proxy": "hanoi109.proxy.mkvn.net:10373:kRQfl:456789",
      "proxyuyquyen": "uqserver01.proxy.mkvn.net:41823",
      "proxiesipuyquyen": "14.225.207.32:41823"
    }
  ]
}

#Ủy quyền ip:port (update iplocal new)

Method: POST

URL: https://proxy.mkvn.net/api/apiv1/uyquyenupdate.php?token=xxxyyyzzz&ordercode=020924EA8A022B82C5&iplocalnew=16.162.21.215

Dữ liệu đầu vào: token (bắt buộc), ordercode (bắt buộc), iplocalnew (bắt buộc)

Kết quả:

{
  "status": "SUCCESS",
  "statusCode": 200,
  "message": "Cập nhật IP thành công.",
  "order_code": "020924EA8A022B82C5",
  "iplocal_new": "16.161.29.217"
}