#Captcha NRO API Documentation

Tài liệu chuẩn tích hợp dịch vụ giải Captcha Ngọc Rồng Online (NRO) tự động qua hình ảnh Base64.

#1. Overview (Tổng quan)

• Base URL: https://phamgiang.net/api/v1/services/captcha-nro
• Content-Type: application/json
• Data Format: UTF-8 JSON

#2. Authentication (Xác thực)

Mọi request gửi tới hệ thống đều yêu cầu xác thực bằng API Key (License key) qua Header:

Lưu ý: Hệ thống cũng hỗ trợ định dạng chuẩn Authorization: Bearer <API_KEY>.

#3. Endpoints (Danh sách API)

#3.1. Solve Captcha (Giải Captcha)

Gửi dữ liệu ảnh Captcha dạng chuỗi Base64 để nhận diện và giải tự động.

• URL: /solve
• Method: POST
• Full URL: https://phamgiang.net/api/v1/services/captcha-nro/solve

#Request Headers

#Request Body

Ví dụ Request:

POST /solve HTTP/1.1
Host: phamgiang.net
Content-Type: application/json
x-api-key: YOUR_API_KEY

{
  "image": "iVBORw0KGgoAAAANSUhEUgAAAGQAAAAyCAYAAAC3Nu..."
}

#Response: Khi thành công (Success — HTTP 200)

Khi request hợp lệ, hệ thống xử lý và trả về HTTP Status 200 cùng dữ liệu kết quả:

{
  "status": 0,
  "captcha": "993175",
  "confidence": 0.9567353,
  "time": 26,
  "message": ""
}

Mô tả các trường dữ liệu:

#Response: Khi phát sinh lỗi API (Backend Error — HTTP 4xx / 5xx)

Khi request vi phạm xác thực, hết hạn ngạch hoặc lỗi kết nối, Backend API trả về mã lỗi HTTP tương ứng cùng cấu trúc JSON chuẩn:

{
  "error": {
    "code": "quota_exhausted",
    "message": "api quota exhausted"
  }
}

Mô tả các trường lỗi:

#4. Error Codes (Bảng Tra Cứu Mã Lỗi)

#4.1. Trạng thái kết quả giải (Trường status trong body HTTP 200)

#4.2. Mã lỗi Backend API (Mã code khi HTTP Status 4xx / 5xx)