Hướng Dẫn Sử Dụng API v1
+ 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.
#Get Balance (Xem số dư)
Method: GET
URL: https://proxy.mkvn.net/api/apiv1/getbalance?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?token=xxxyyyzzz
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?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?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
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?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",
"value_order": 2080,
"new_expiry_time": "02-10-2024",
"remaining_balance": 3985440
}
#Renewal On/Off (Bật/Tắt Gia Hạn Theo Đơn)
Method: POST
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?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
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?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?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"
}
]
}
#WireGuard VPN (list)
Method: GET
URL: https://proxy.mkvn.net/api/apiv1/wglist?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!",
"total": 1,
"data": [
{
"order_code": "020924EA8A022B82C5",
"server": "01",
"wg_port": 12440,
"endpoint": "wg01.proxy.mkvn.net:12440",
"proxy_goc": "sp10-asia.proxy.mkvn.net:33739:sp10-singa33739:HTDQP",
"client_conf": "[Interface]\nAddress = 10.100.38.38/30\nPrivateKey = sMXPFuoT9+9UqDHmdvm+sOkggROMpFZtYi913eJwmE=\nListenPort = 51820\n\n[Peer]\nPublicKey = CGcur+yrB8LC87GE6KKQrr2sNcxNizjDEmDp52UwjE=\nPresharedKey = o4IZKz7pZ3Ox4bohM8MmBzuui1iLUTzGpYn7lAOhPc=\nEndpoint = wg01.proxy.mkvn.net:12440\nAllowedIPs = 0.0.0.0/0\nPersistentKeepalive = 25",
"date": "2026-05-04 08:37:19"
}
]
}
#WireGuard VPN (add)
Method: POST
URL: https://proxy.mkvn.net/api/apiv1/wgadd?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": "Tạo thành công 1 WireGuard peer.",
"order_code": "020924EA8A022B82C5",
"created": 1,
"skipped": 0,
"data": [
{
"server": "01",
"wg_port": 12440,
"endpoint": "wg01.proxy.mkvn.net:12440",
"client_conf": "[Interface]\nAddress = 10.100.38.38/30\nPrivateKey = sMXPFuoT9+9UqDHmdvm+sOkggROMpFZtYi913eJwmE=\nListenPort = 51820\n\n[Peer]\nPublicKey = CGcur+yrB8LC87GE6KKQrr2sNcxNizjDEmDp52UwjE=\nPresharedKey = o4IZKz7pZ3Ox4bohM8MmBzuui1iLUTzGpYn7lAOhPc=\nEndpoint = wg01.proxy.mkvn.net:12440\nAllowedIPs = 0.0.0.0/0\nPersistentKeepalive = 25",
}
]
}
#Ủy quyền ip:port (list)
Method: GET
URL: https://proxy.mkvn.net/api/apiv1/uyquyenlist?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
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
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"
}
#Userpass (list)
Method: GET
URL: https://proxy.mkvn.net/api/apiv1/userpasslist?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",
"proxy_http": "hanoi107.proxy.mkvn.net:10473:yGwTU:64831",
"proxy_userpass": "user01.proxy.mkvn.net:14920:nlhmreyqs:fswrlkz",
"proxy_ip_userpass": "103.82.27.213:14920:nlhmreyqs:fswrlkz",
"time_add": "2025-03-12 18:53:31",
"time_change": "2025-03-12 18:53:31"
},
]
}
#Userpass (add)
Method: POST
Dữ liệu đầu vào: token (bắt buộc), ordercode (bắt buộc), user (không bắt buộc), pass (không bắt buộc)
Kết quả:
{
"status": "SUCCESS",
"statusCode": 200,
"message": "Xử lý thành công! Vui lòng chờ 10 phút để hệ thống cập nhật",
"order_code": "020924EA8A022B82C5",
"proxies": [
"user20.proxy.mkvn.net:30207:nguoidung01353307:matkhau01",
"user20.proxy.mkvn.net:32429:nguoidung01123424:matkhau01"
],
"proxies_ip": [
"103.82.27.4:30207:nguoidung01353307:matkhau01",
"103.82.27.4:32429:nguoidung01123424:matkhau01"
]
}
#Userpass (update pass)
Method: POST
Dữ liệu đầu vào: token (bắt buộc), ordercode (bắt buộc), pass (không bắt buộc)
Kết quả:
{
"status": "SUCCESS",
"statusCode": 200,
"message": "Cập nhật mật khẩu proxy thành công. Vui lòng chờ 10 phút để hệ thống cập nhật",
"order_code": "020924EA8A022B82C5",
"proxies_update": [
"user20.proxy.mkvn.net:30207:nguoidung01353307:matkhau02",
"user20.proxy.mkvn.net:32429:nguoidung01123424:matkhau02"
],
"proxies_ip_update": [
"103.82.27.4:30207:nguoidung01353307:matkhau02",
"103.82.27.4:32429:nguoidung01123424:matkhau02"
]
}
#Cron Link SP07v2 (list)
Method: GET
URL: https://proxy.mkvn.net/api/apiv1/sp07v2cronlist?token=xxxyyyzzz&ordercode=140325EUR5P3O1TAH4
Dữ liệu đầu vào: token (bắt buộc), ordercode (không bắt buộc - nếu không khai báo thì sẽ lấy full list)
Kết quả:
{
"status": "SUCCESS",
"statusCode": 200,
"message": "Truy vấn thành công!",
"data": [
{
"order_code": "140325EUR5P3O1TAH4",
"link_reset": "https://proxy.mkvn.net/sp07v2/37202-VAIIBQUDMA",
"time_cron_minues": "3",
"time_add": "2025-03-14 14:37:45",
"time_change": "2025-03-14 14:43:04"
},
{
"order_code": "140325EUR5P3O1TAH4",
"link_reset": "https://proxy.mkvn.net/sp07v2/37203-RAXSFTDLCP",
"time_cron_minues": "3",
"time_add": "2025-03-14 14:37:45",
"time_change": "2025-03-14 14:43:05"
}
]
}
#Cron Link SP07v2 (add & update)
Method: POST
URL: https://proxy.mkvn.net/api/apiv1/sp07v2cronadd?token=xxxyyyzzz&ordercode=020924EA8A022B82C5&time=3
Dữ liệu đầu vào: token (bắt buộc), ordercode (bắt buộc), time (bắt buộc phải lớn hơn 1 và nhỏ hơn 1.000.000 - tính bằng phút)
Kết quả:
{
"status": "SUCCESS",
"statusCode": 200,
"message": "Xử lý thành công!",
"order_code": "140325EUR5P3O1TAH4",
"inserted_links": [
{
"link_reset": "https://proxy.mkvn.net/sp07v2/37202-VAIIBQUDMQ",
"time_cron_minues": 3
},
{
"link_reset": "https://proxy.mkvn.net/sp07v2/37203-RAXSFTDLCS",
"time_cron_minues": 3
}
],
"updated_links": []
}