API Reference

Integrate SmartGuard malware detection into your own applications seamlessly. Below you'll find the endpoint details and code examples.

POST /process_scan.php

Uploads a file (APK/ZIP) to the server, triggers the malware analysis engine, and returns a JSON response containing the scan ID and status.

Request Parameters

Parameter	Type	Description
`file`	File (Binary)	Required. The APK or ZIP file to be scanned (Max 32MB). Must be sent as `multipart/form-data`.

Integration Examples

Python (Requests)

import requests

url = "https://yourdomain.com/checker/process_scan.php"
file_path = "app-release.apk"

with open(file_path, "rb") as file:
    files = {"file": (file_path, file, "application/vnd.android.package-archive")}
    response = requests.post(url, files=files)

print(response.json())

cURL

curl -X POST https://yourdomain.com/checker/process_scan.php \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/your/app-release.apk"

JSON Response

On a successful request, the API will return the following JSON structure:

{
  "status": "success",
  "vt_id": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "positives": 0,
  "total": 72,
  "message": "System Engine Analysis Complete."
}