Drokio — guardián digitalDROKIO
Volver a Documentación

SDKs por lenguaje

Cada guía incluye instalación, inicialización del cliente y 5 ejemplos reales: verificar tu key, enviar telemetría, listar sitios, disparar un scan y analizar código con Brain IA. Los snippets usan placeholders tipo YOUR_API_KEY — reemplazalos por una key emitida desde el dashboard.

Elegí tu stack

JavaScript

Node 18+, Bun, Deno y browsers modernos.

Ver guía
Python

Python 3.9+ con type hints y async opcional.

Ver guía
PHP

PHP 8.1+ vía Composer. Funciona con WordPress.

Ver guía
cURL

Sin dependencias. Ideal para scripts CI y demos.

Ver guía

JavaScript

Node 18+, Bun, Deno y browsers modernos.

Instalación

cURL
# npm
npm install @drokio/sdk

# pnpm / yarn
pnpm add @drokio/sdk
yarn add @drokio/sdk

Inicialización

drokio.tsJavaScript
import { DrokioClient } from "@drokio/sdk";

const drokio = new DrokioClient({
  apiKey: process.env.DROKIO_API_KEY!,
  // Opcional: apiBase: "https://drokio.com"
});

Ejemplos

1

Verificar API key

JavaScript
const status = await drokio.auth.verify();
console.log(status.plan, status.sites_used, "/", status.sites_allowed);
2

Enviar telemetría

JavaScript
await drokio.telemetry.send({
  site_url: "https://mi-tienda.com",
  event_type: "file_modification",
  severity: "warning",
  message: "wp-config.php modificado manualmente",
  metadata: { file: "wp-config.php", ip: "203.0.113.22" },
});
3

Listar sitios

JavaScript
const { sites } = await drokio.sites.list({ status: "warning" });
sites.forEach((s) => console.log(s.url, s.alerts_open));
4

Ejecutar scan

JavaScript
const scan = await drokio.scanner.run({
  site_url: "https://mi-tienda.com",
  scan_type: "full",
});
console.log("Hallazgos:", scan.findings.length);
5

Analizar código con Brain

JavaScript
const verdict = await drokio.brain.analyze({
  input_type: "code",
  content: phpSource,
  site_url: "https://mi-tienda.com",
});
if (verdict.verdict === "malicious") {
  await quarantine(phpSource);
}

Python

Python 3.9+ con type hints y async opcional.

Instalación

cURL
# pip
pip install drokio

# poetry
poetry add drokio

Inicialización

drokio_client.pyPython
import os
from drokio import DrokioClient

drokio = DrokioClient(api_key=os.environ["DROKIO_API_KEY"])

Ejemplos

1

Verificar API key

Python
status = drokio.auth.verify()
print(status.plan, status.sites_used, "/", status.sites_allowed)
2

Enviar telemetría

Python
drokio.telemetry.send(
    site_url="https://mi-tienda.com",
    event_type="file_modification",
    severity="warning",
    message="wp-config.php modificado manualmente",
    metadata={"file": "wp-config.php", "ip": "203.0.113.22"},
)
3

Listar sitios

Python
result = drokio.sites.list(status="warning")
for s in result["sites"]:
    print(s["url"], s["alerts_open"])
4

Ejecutar scan

Python
scan = drokio.scanner.run(
    site_url="https://mi-tienda.com",
    scan_type="full",
)
print("Hallazgos:", len(scan["findings"]))
5

Analizar código con Brain

Python
verdict = drokio.brain.analyze(
    input_type="code",
    content=php_source,
    site_url="https://mi-tienda.com",
)
if verdict["verdict"] == "malicious":
    quarantine(php_source)

PHP

PHP 8.1+ vía Composer. Funciona con WordPress.

Instalación

cURL
# Composer
composer require drokio/sdk

Inicialización

drokio.phpPHP
<?php
require 'vendor/autoload.php';

use Drokio\DrokioClient;

$drokio = new DrokioClient([
    'api_key' => getenv('DROKIO_API_KEY'),
]);

Ejemplos

1

Verificar API key

PHP
$status = $drokio->auth->verify();
echo $status->plan . ' ' . $status->sites_used . '/' . $status->sites_allowed;
2

Enviar telemetría

PHP
$drokio->telemetry->send([
    'site_url'   => 'https://mi-tienda.com',
    'event_type' => 'file_modification',
    'severity'   => 'warning',
    'message'    => 'wp-config.php modificado manualmente',
    'metadata'   => [
        'file' => 'wp-config.php',
        'ip'   => '203.0.113.22',
    ],
]);
3

Listar sitios

PHP
$result = $drokio->sites->list(['status' => 'warning']);
foreach ($result['sites'] as $site) {
    echo $site['url'] . ' → ' . $site['alerts_open'] . " alertas\n";
}
4

Ejecutar scan

PHP
$scan = $drokio->scanner->run([
    'site_url'  => 'https://mi-tienda.com',
    'scan_type' => 'full',
]);
echo 'Hallazgos: ' . count($scan['findings']);
5

Analizar código con Brain

PHP
$verdict = $drokio->brain->analyze([
    'input_type' => 'code',
    'content'    => $phpSource,
    'site_url'   => 'https://mi-tienda.com',
]);
if ($verdict['verdict'] === 'malicious') {
    quarantine($phpSource);
}

cURL

Sin dependencias. Ideal para scripts CI y demos.

Instalación

cURL
# cURL viene preinstalado en la mayoría de sistemas Unix.
# Windows: scoop install curl  |  macOS: brew install curl  |  Linux: apt install curl

Inicialización

.env / shellcURL
# Exportá tu API key para no repetirla
export DROKIO_API_KEY="dk_live_…"

Ejemplos

1

Verificar API key

cURL
curl -X POST https://drokio.com/api/v1/auth/verify \
  -H "Authorization: Bearer $DROKIO_API_KEY"
2

Enviar telemetría

cURL
curl -X POST https://drokio.com/api/v1/telemetry \
  -H "Authorization: Bearer $DROKIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "site_url": "https://mi-tienda.com",
    "event_type": "file_modification",
    "severity": "warning",
    "message": "wp-config.php modificado manualmente"
  }'
3

Listar sitios

cURL
curl -G https://drokio.com/api/v1/sites \
  -H "Authorization: Bearer $DROKIO_API_KEY" \
  -d "status=warning"
4

Ejecutar scan

cURL
curl -X POST https://drokio.com/api/v1/scanner \
  -H "Authorization: Bearer $DROKIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "site_url": "https://mi-tienda.com", "scan_type": "full" }'
5

Analizar código con Brain

cURL
curl -X POST https://drokio.com/api/v1/brain/analyze \
  -H "Authorization: Bearer $DROKIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_type": "code",
    "content": "<?php … ?>",
    "site_url": "https://mi-tienda.com"
  }'

Los SDKs oficiales están en beta

Si preferís no usar una librería, los ejemplos en cURL muestran el contrato HTTP exacto — podés hablar con la API usando cualquier cliente HTTP. La referencia completa de endpoints vive en /docs/api-reference.

Ver referencia de APIVolver al inicio