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 buy (các api truy vấn khác mọi thành viên đều được sử dụng)
+ 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.

#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",
  "level": "PARTNER",
  "balance": 42720,
  "chietkhau": 20
}

#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,
      "catalogue": "SP01",
      "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?token=xxxyyyzzz&id_product=15&quantity=2&renewal=off&note=kh%C3%A1ch%20s%E1%BB%91%201

Yêu cầu: Cấp Partner

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"), note (tùy chọn)

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",
  "note": "khách số 1",
  "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"
}