Tài liệu API

Tích hợp phát hiện lừa đảo vào ứng dụng của bạn với REST API của chúng tôi.

Xác thực

Tất cả yêu cầu API đều cần Bearer token. Nhận API key bằng cách đăng ký gói API.

Authorization: Bearer your_api_key_here

Endpoints

POST/api/v1/check

Phân tích nội dung để tìm chỉ số lừa đảo.

{
  "content": "Your suspicious text here...",
  "input_type": "text",  // "text" | "url" | "email"
  "locale": "en"         // optional, for explanation language
}

POST/api/v1/bulk

Kiểm tra nhiều URL hoặc nội dung trong một yêu cầu duy nhất.

{
  "items": [
    { "content": "https://suspicious-url.com" },
    { "content": "Check this email text..." }
  ]
}

Định dạng phản hồi

{
  "id": "abc123xyz",
  "verdict": "likely_scam",
  "composite_score": 72,
  "confidence": 88,
  "scam_type": "phishing",
  "explanation": "This message...",
  "red_flags": [...],
  "layers": [...],
  "processing_time_ms": 2340
}

Giới hạn tốc độ

Gói API: 10.000 yêu cầu mỗi ngày. Gói doanh nghiệp: không giới hạn.