REST API

Taramalarını Discord botuna, ticket sistemine veya FiveM sunucuna bağla. API Professional ve Enterprise planlarında açıktır; API ile PIN oluşturma yalnızca Enterprise'dadır.

Kimlik doğrulama

Panelinden API sayfasında bir anahtar oluştur. Her istekte Authorization başlığıyla gönder. Anahtar yalnızca oluşturulduğu anda gösterilir; sunucuda sadece hash'i saklanır.

Authorization: Bearer ds_live_xxxxxxxxxxxxxxxxxxxxxxxx

Limitler ve hatalar

Anahtar başına dakikada 90 istek. Hatalar JSON döner:

Kod	error	Anlamı
401	missing_api_key / invalid_api_key	Başlık eksik ya da anahtar iptal edilmiş.
402	plan_required	Planın bu uç noktayı kapsamıyor. required alanı gereken planı söyler.
404	not_found	Kayıt bulunamadı ya da sana ait değil.
429	rate_limited	Bir dakika bekle.

Hesap

GET/api/v1/me

Anahtarın bağlı olduğu hesabı ve aktif planı döner.

Taramalar

GET/api/v1/scans

Son taramaları listeler. Sorgu parametreleri: limit (1-100, varsayılan 25), verdict (detected, suspicious, clean).

{ "data": [{ "id": "UUwr7CELG7Wb", "pin": "4372W979", "status": "completed", "verdict": "detected", "riskScore": 100, "detectionCount": 8, "hostname": "DESKTOP-7Q2LM4K", "completedAt": "2026-10-09T20:36:42Z" }] }

GET/api/v1/scans/:id

Tek bir taramanın tamamı: sistem bilgisi, hesaplar, tespitler ve kanıtlar. Ham artefaktlar için ?artifacts=1 ekle.

PIN'ler

GET/api/v1/pins

Son 100 PIN'i ve durumlarını listeler.

GET/api/v1/pins/:code

PIN'in durumunu ve varsa bağlı taramanın özetini döner. Botun taramanın bitip bitmediğini bununla kontrol edebilir.

POST/api/v1/pins Enterprise

Yeni tarama PIN'i oluşturur. Gövde: label (isteğe bağlı), count (1-10).

curl -X POST https://SITEN/api/v1/pins \ -H "Authorization: Bearer ds_live_…" \ -H "Content-Type: application/json" \ -d '{"label":"ticket-4412"}' # 201 { "data": [{ "code": "8P2LKD4N", "status": "waiting", "expiresAt": "…" }] }

Scanner protokolü

Oyuncunun çalıştırdığı DreamScanner.exe sunucuyla üç adımda konuşur. Kendi istemcini yazmak istersen sözleşme budur.

POST/api/scanner/handshake

{ pin, version, machine: { hostname, user, os, hwid } } gönderir. Yanıtta tek kullanımlık session ile müşterinin özel string'leri, tespit betikleri ve araç tasarımcısı ayarları gelir.

POST/api/scanner/progress

{ session, progress, stage, liveDetection? }. Paneldeki canlı akış bu çağrılarla beslenir.

POST/api/scanner/submit

{ session, system, accounts, detections[], artifacts{}, moduleStats[], durationMs }. Sunucu, özel string ve betikleri artefaktlara tekrar uygular, risk puanını ve kararı hesaplar.