API Captcha
Bắt đầu
Mua key ở Captcha, xem key ở Captcha của tôi. Key gửi trong body hoặc query, không dùng Bearer token.
URL gốc: https://vpsnet.vn
Dùng POST
GET vẫn chạy nhưng key nằm trên URL và dễ lộ trong log. Nên gửi POST với JSON, form hoặc multipart.
Captcha NRO POST | GET
/api/captcha/nro| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| key | api_key | merchant_key | apikey | Có | Key NRO mua ở trang Captcha. |
| image | img | captcha | Có | Ảnh base64 (có hoặc không có tiền tố data URL). Hoặc gửi file ảnh ở field file (multipart). |
Ảnh png, jpeg hoặc webp, tối đa 1MB. Không nhận diện được ảnh thì không trừ lượt.
curl (JSON)
curl -X POST "https://vpsnet.vn/api/captcha/nro" \
-H "Content-Type: application/json" \
-d '{"key":"NRO-XXXXXXXX","image":"<ảnh base64>"}'curl (multipart)
curl -X POST "https://vpsnet.vn/api/captcha/nro" \
-F "key=NRO-XXXXXXXX" \
-F "file=@captcha.png"Python
import base64, requests
with open("captcha.png", "rb") as f:
image = base64.b64encode(f.read()).decode()
r = requests.post(
"https://vpsnet.vn/api/captcha/nro",
json={"key": "NRO-XXXXXXXX", "image": image},
timeout=20,
)
data = r.json()
if data["success"]:
print(data["captcha"])
else:
print(data.get("code"), data["message"])C#
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(20) };
using var form = new MultipartFormDataContent();
form.Add(new StringContent("NRO-XXXXXXXX"), "key");
form.Add(new ByteArrayContent(File.ReadAllBytes("captcha.png")), "file", "captcha.png");
var res = await http.PostAsync("https://vpsnet.vn/api/captcha/nro", form);
Console.WriteLine(await res.Content.ReadAsStringAsync());Thành công (200)
{ "success": true, "captcha": "abcd", "message": "" }Lỗi
{ "success": false, "captcha": "", "message": "Key đã hết lượt.", "code": "LICENSE_OUT_OF_BALANCE" }Turnstile POST | GET
/api/captcha/turnstile| Tham số | Bắt buộc | Mô tả |
|---|---|---|
| key | api_key | merchant_key | apikey | Có | Key Turnstile mua ở trang Captcha. |
| websiteURL | website_url | Có | Địa chỉ trang có Turnstile, bắt đầu bằng http hoặc https. |
| websiteKey | sitekey | Không | Sitekey của Turnstile nếu có. |
Thời gian chờ
Mỗi lần giải mất tối đa 45 giây. Đặt timeout phía client từ 60 giây trở lên. Gặp 429 thì chờ rồi gửi lại, không gửi dồn.
curl
curl -X POST "https://vpsnet.vn/api/captcha/turnstile" \
-H "Content-Type: application/json" \
-d '{"key":"TS-XXXXXXXX","websiteURL":"https://example.com/login","websiteKey":"0x4AAAAAAA..."}'Python
import requests
r = requests.post(
"https://vpsnet.vn/api/captcha/turnstile",
json={
"key": "TS-XXXXXXXX",
"websiteURL": "https://example.com/login",
"websiteKey": "0x4AAAAAAA...",
},
timeout=70, # server chờ tối đa 45 giây, đặt timeout từ 60 giây
)
data = r.json()
print(data["token"] if data["success"] else data.get("code"))C#
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(70) };
var body = new StringContent(
"{\"key\":\"TS-XXXXXXXX\",\"websiteURL\":\"https://example.com/login\"}",
System.Text.Encoding.UTF8, "application/json");
var res = await http.PostAsync("https://vpsnet.vn/api/captcha/turnstile", body);
Console.WriteLine(await res.Content.ReadAsStringAsync());Thành công (200)
{ "success": true, "token": "0.xxxxx...", "message": "" }Mã lỗi
| Mã (code) | HTTP | Ý nghĩa |
|---|---|---|
| LICENSE_REQUIRED | 401 | Thiếu key. |
| LICENSE_INVALID | 401 | Key không tồn tại. |
| LICENSE_WRONG_TYPE | 401 | Key không dùng cho loại captcha này. |
| LICENSE_SUSPENDED / LICENSE_REVOKED | 401 | Key bị khoá hoặc đã thu hồi. |
| LICENSE_EXPIRED | 401 | Key thời gian đã hết hạn. |
| LICENSE_OUT_OF_BALANCE | 401 | Key NRO hết lượt. |
| INSUFFICIENT_BALANCE | 402 | Key Turnstile hết credit. |
| LICENSE_DAILY_LIMIT_REACHED | 401 | Key thời gian hết lượt trong ngày. |
| LICENSE_IP_LIMIT_REACHED | 401 | Key đã đủ số IP, reset IP trong Captcha của tôi. |
| CAPTCHA_UNSOLVED | 422 | Không nhận diện được ảnh, không trừ lượt. |
| WEBSITE_URL_REQUIRED | 400 | Turnstile thiếu hoặc sai websiteURL. |
| TOO_MANY_REQUESTS | 429 | Gửi quá nhiều, chờ rồi thử lại. |
| SOLVE_FAILED | 500 | Turnstile giải lỗi, đã hoàn credit. |
| SERVICE_BUSY | 503 | Máy chủ bận hoặc đang bảo trì, thử lại sau. |
Giới hạn
- Ảnh NRO tối đa 1MB.
- Tối đa 120 yêu cầu mỗi phút cho mỗi IP.
- Key sai quá nhiều lần sẽ bị chặn tạm thời (429).
- Mỗi key gắn tối đa số IP của gói, reset IP trong Captcha của tôi.
- Phản hồi luôn có success và message, lỗi có thêm code.