Akses Dokumentasi VirusTotal API
VirusTotal tidak menyimpan dokumentasi API utamanya secara langsung di repositori GitHub publik sebagai sumber utama, melainkan melalui portal dokumentasi resmi di docs.virustotal.com. Namun, VirusTotal menyediakan berbagai pustaka (library) pendukung dan contoh implementasi di akun GitHub resmi mereka untuk memudahkan pengembang melakukan integrasi.
Untuk memulai, Anda memerlukan API Key yang didapatkan melalui profil pengguna di situs VirusTotal. API v3 adalah standar saat ini yang menggunakan format JSON dan protokol RESTful.
Sumber Daya Resmi di GitHub
Berikut adalah daftar repositori resmi yang dikelola oleh tim VirusTotal untuk membantu integrasi API:
| Nama Repositori | Fungsi Utama | Bahasa |
|---|---|---|
| vt-py | Client library resmi untuk API v3 | Python |
| vt-cli | Command line interface untuk VirusTotal | Go |
| yara-python | Integrasi aturan YARA | Python/C |
Langkah Integrasi API v3
Untuk menggunakan API v3, Anda harus mengirimkan permintaan HTTP ke endpoint https://www.virustotal.com/api/v3/. Berikut adalah contoh sederhana menggunakan Python dengan pustaka vt-py:
import vt
# Inisialisasi client dengan API Key Anda
client = vt.Client("YOUR_API_KEY_HERE")
# Mengambil informasi file berdasarkan hash
file_info = client.get_object("/files/<FILE_HASH>")
print(file_info.last_analysis_stats)
client.close()Batasan dan Kuota API
Penting untuk memahami batasan penggunaan API agar akun Anda tidak diblokir. VirusTotal menerapkan sistem kuota berdasarkan jenis akun (Public vs Premium).
| Jenis Akun | Limit Harian | Limit Per Menit |
|---|---|---|
| Public API | 500 | 4 |
| Premium API | Sesuai Kontrak | Sesuai Kontrak |
Tips Troubleshooting
- 403 Forbidden: Pastikan API Key Anda valid dan tidak kedaluwarsa.
- 429 Too Many Requests: Anda telah melampaui limit per menit. Implementasikan exponential backoff pada kode Anda.
- Format JSON: Selalu validasi respons JSON sebelum memproses data untuk menghindari error parsing.
Untuk dokumentasi teknis mendalam mengenai setiap endpoint (seperti /files, /urls, /domains, dan /ip_addresses), kunjungi situs dokumentasi resmi di https://docs.virustotal.com/reference/overview.