Hướng dẫn sử dụng api

Nếu phần mềm của bạn chạy trên window, mong các bạn sử dụng qua Driver bên mình để tránh bị spam request dẫn tới ban key, và hỗ trợ bên mình cũng dễ dàng xử lý hơn nếu phần mềm khách các bạn đang sử dụng phát sinh lỗi lấy IP. Link: https://tinsoftproxy.com/api/driver_document.php

(Thời gian giữa 2 request khuyến nghị là trên 10s - yêu cầu trên 5s, vượt quá nhiều lần bạn tk của bạn sẽ bị ban)

Github C#: https://github.com/sonytuan/TinsoftProxy-.net

Github MultiThreads C#: https://github.com/sonytuan/TinsoftProxy-Multi-Threads

Github Java: https://github.com/sonytuan/TinsoftProx-_Java

Lấy IP mới

Đường dẫn: http://proxy.tinsoftsv.com/api/changeProxy.php?key=[api_key]&location=[location_id]

Lấy danh sách vị trí:http://proxy.tinsoftsv.com/api/getLocations.php

Giá trị trả về (dạng json):

Thành công :

{"success":true,"proxy":"117.1.95.345:12345" , "location":1 , "next_change":"120" , "timeout":641, "accept_ip":"1.2.3.4"}

- proxy: bao gồm ip và port - timeout: Thời gian còn lại có thể sử dụng (đơn vị giây), sau khi hết tgian này, proxy tự động chết. Key VIP ko timeout. - next_change: Thời gian giới hạn cho lượt đổi ip kế tiếp (đơn vị giây).

-location: Vị trí của IP
-accept_ip: Chỉ IP này mới có thể sử dụng proxy<>

Thất bại :

{"success":false,"description":"proxy not found! please try again or contact us."}

- description: Nguyên nhân thất bại

Kiểm tra ip hiện tại

Đường dẫn: http://proxy.tinsoftsv.com/api/getProxy.php?key=[api_key]

Giá trị trả về (dạng json):

Thành công :

{"success":true,"proxy":"117.1.95.345:12345"  , "location":1 , "next_change":"110" , "timeout":641, "accept_ip":"1.2.3.4"}

Thất bại :

{"success":false,"description":"proxy not found!"}

- description: Nguyên nhân thất bại. Hãy quay lại bước 1 dể lấy 1 proxy mới nhé.

Kiểm tra trạng thái của key

Đường dẫn: http://proxy.tinsoftsv.com/api/getKeyInfo.php?key=[api_key]

Giá trị trả về (dạng json):

Thành công :

{"success":true,"date_expired":"13-02-2020 23:11:39","isVip":0}

- date_expired: Ngày hết hạng của key API, isVip: Key này có quyền sử dụng gói VIP nào hay không

-location: Vị trí của IP

Thất bại :

{"success":false,"description":"wrong key!"}

- description: Nguyên nhân thất bại

Xóa 1 key

Đường dẫn: http://proxy.tinsoftsv.com/api/deleteKey.php?key=[api_key]

Giá trị trả về (dạng json): Lưu ý không xóa được key còn hạn dùng!

Thành công :

{"success":true,"description":"Key deleted!"}

Kiểm tra tất cả keys của user

Đường dẫn: http://proxy.tinsoftsv.com/api/getUserKeys.php?key=[user_api_key]

Lấy api key của user tại: http://proxy.tinsoftsv.com/userInfo.php - Lưu ý key này dùng để quản lý user, khác với key của proxy

Giá trị trả về (dạng json):

Thất bại :

{"success":false,"description":"wrong key!"}

- description: Nguyên nhân thất bại

Thành công :


		   {"success":true,
			"data":[{
					"success":false, //true: key còn hoạt động - false: key hết hạn hoặc lỗi
					"key":"Ku8NFADokLRtN76",
					"description":"key expired!",
					"date_expired":18-01-2020 06:32:30,
					"isVip":false
				},
				{
				...
				}
			]
		  }

Kiểm tra thông tin người dùng

Đường dẫn: http://proxy.tinsoftsv.com/api/getUserInfo.php?key=[user_api_key]

Giá trị trả về (dạng json):

Thành công :

{"success":true,"max_key":"10", //Tổng số key user này được tạo
  "balance":"15000","paid":"150000", //Số dư, tổng tiền đã nạp
  "wallet_key":"WLgU8sdFPPamCU",
  "description":""}

Mua thêm keys

Đường dẫn: http://proxy.tinsoftsv.com/api/orderKeys.php?key=[user_api_key]&quantity=[so_luong]&days=[ngay_su_dung]&vip=[0/1/2]&referer=[mã_ref(nếu có)]

Giá trị trả về (dạng json):

Giá trị nhập vào: vip=0: key thường, vip=1: key vip ko timeout, vip=2: key vip dùng nhanh (1phút được đổi ip)

Thành công :

{"success":true ,
"data":[
{"key":"newKey1","success":true,"description":"","date_expired":"27-02-2020 15:14:50","isVip":null},
{"key":"newKey2","success":true,"description":"","date_expired":"27-02-2020 15:14:50","isVip":null},
...
],"description":""}

Gia hạn 1 key

Đường dẫn: http://proxy.tinsoftsv.com/api/extendKey.php?key=[user_api_key]&days=[ngay_su_dung]&proxy_key=[key_can_gia_han]&referer=[mã_ref(nếu có)]

Giá trị trả về (dạng json):

Giá trị nhập vào: Vui lòng truyền vào cả key người dùng và key proxy, để xác minh bạn có quyền gia hạn key đó hay không

Thành công :

{"success":true ,"description":""}

Thông tin liên hệ

SDT : ...