Developer Docs

SDK & API Reference

Integrate Jidar into your stack with our TypeScript, Python, PHP, Go, Java, and .NET SDKs. Full REST & WebSocket API.

Developer Docs

Quick Start Guide

Get Jidar SecOps collecting events from your infrastructure in under 5 minutes. Send logs via our API or SDKs.

Authentication

All API requests require a Bearer token. Generate one from your dashboard under Settings → API Keys.

# Set your API key as an environment variable
export JIDAR_API_KEY="<your-api-key>"

TypeScript / Node.js SDK

npm install @jidar/sdk
import { JidarClient } from '@jidar/sdk';

const client = new JidarClient({ apiKey: '<your-api-key>' });

await client.events.send({
  source: 'nginx',
  type: 'port_scan',
  severity: 'medium',
  ip: '10.0.0.99'
});

Python SDK

Install via pip and start sending events in seconds.

pip install jidar-sdk
import jidar

client = jidar.Client(api_key="<your-api-key>")

# Send a security event
client.events.send({
  "source": "web-server-01",
  "type": "auth_failure",
  "severity": "high",
  "ip": "192.168.1.45",
  "user": "root"
})

PHP SDK

composer require jidar/sdk
use Jidar\JidarClient;

$client = new JidarClient(['apiKey' => '<your-api-key>']);

$client->events->send([
  'source' => 'apache',
  'type' => 'sql_injection',
  'severity' => 'critical'
]);

Go SDK

go get github.com/jidar0x0/jidar-sdk-go
import "github.com/jidar0x0/jidar-sdk-go"

client := jidar.NewClient("<your-api-key>")

client.CaptureEvent(jidar.Event{
  Source: "api-gateway",
  Type: "rate_limit_exceeded",
})

Java SDK

<dependency>
  <groupId>io.jidar</groupId>
  <artifactId>jidar-sdk</artifactId>
  <version>0.1.0</version>
</dependency>
import io.jidar.JidarClient;

JidarClient client = new JidarClient("<your-api-key>");

client.events().send(new Event()
  .source("tomcat")
  .type("unauthorized_access")
  .severity("high"));

.NET SDK

dotnet add package Jidar.Sdk
using Jidar;

var client = new JidarClient("<your-api-key>");

await client.Events.SendAsync(new SecurityEvent
{
  Source = "iis",
  Type = "brute_force",
  Severity = "critical",
  Ip = "203.0.113.50"
});

REST API — Events

Send events directly via HTTP POST. Supports batch ingestion up to 1,000 events per request.

POST https://api.jidar0x0.com/api/logs/batch
Authorization: Bearer <server-side-api-key>
Content-Type: application/json

{
  "events": [{
    "source": "firewall-edge",
    "type": "blocked_connection",
    "severity": "low",
    "timestamp": "2026-04-24T12:00:00Z"
  }]
}

Webhooks

Subscribe to real-time threat notifications. Jidar will POST to your endpoint whenever a high-severity event is detected.

# Webhook payload example (JSON)
{
  "event": "threat.detected",
  "severity": "HIGH",
  "source_ip": "91.142.33.7",
  "description": "Brute-force SSH — 512 attempts/min",
  "timestamp": "2026-04-24T12:01:00Z"
}