Documentazione API

Tutto cio di cui hai bisogno per integrare Seizn nelle tue applicazioni. Aggiungi memoria persistente alla tua IA con poche righe di codice.

Avvio Rapido

Ottieni la tua chiave API dal pannello di controllo, poi inizia a fare richieste:

bash

# Add a memory
curl -X POST https://seizn.com/api/memories \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "User prefers dark mode interfaces"}'

# Search memories
curl "https://seizn.com/api/memories?query=user+preferences" \
  -H "Authorization: Bearer YOUR_API_KEY"

Autenticazione

Tutte le richieste API richiedono una chiave API passata nell'header x-api-key .

bash

curl -H "Authorization: Bearer szn_your_api_key_here" \
  https://seizn.com/api/memories?query=test

Sicurezza: Mantieni segrete le tue chiavi API. Non esporle mai nel codice lato client. Usa variabili d'ambiente o un proxy backend.

Endpoint API

POST/api/memories

Aggiungi un nuovo ricordo all'archivio memoria dell'utente.

Corpo della richiesta

content-string (required)

memory_type-string - fact, preference, experience, relationship, instruction

tags-string[]

namespace-string (default: "default")

scope-string - user, session, agent

session_id-string

agent_id-string

Risposta

{
  "success": true,
  "memory": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "content": "User prefers dark mode interfaces",
    "memory_type": "preference",
    "tags": ["ui", "settings"],
    "namespace": "default",
    "created_at": "2026-01-08T10:30:00Z"
  }
}

GET/api/memories

Cerca memorie usando similarita semantica.

Parametri query

query-string (required)

limit-number (default: 10, max: 100)

threshold-number 0-1 (default: 0.7)

namespace-string

Risposta

{
  "success": true,
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "content": "User prefers dark mode interfaces",
      "memory_type": "preference",
      "tags": ["ui", "settings"],
      "similarity": 0.89
    }
  ],
  "count": 1
}

DELETE/api/memories

Elimina memorie tramite i loro ID.

Parametri query

ids-string (required) - comma-separated

Risposta

{
  "success": true,
  "deleted": 3
}

POST/api/extract

Estrae e archivia memorie da una conversazione usando IA.

Corpo della richiesta

conversation-string (required)

model-string - haiku | sonnet (default: haiku)

auto_store-boolean (default: true)

namespace-string (default: "default")

Risposta

{
  "message": "Extracted 3 memories, stored 3",
  "extracted": [
    {
      "content": "User is a software developer working with Python",
      "memory_type": "fact",
      "tags": ["profession", "programming"],
      "confidence": 0.95,
      "importance": 7
    }
  ],
  "stored": [...]
}

POST/api/query

Ottieni risposte generate dall'IA usando memorie rilevanti come contesto (RAG).

Corpo della richiesta

query-string (required)

model-string - haiku | sonnet (default: haiku)

top_k-number (default: 5)

namespace-string

include_memories-boolean (default: true)

Risposta

{
  "response": "Based on your preferences, I'd recommend using VS Code with a dark theme...",
  "memories_used": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "content": "User prefers dark mode interfaces",
      "similarity": 0.85
    }
  ],
  "model_used": "haiku"
}

Limiti di Frequenza

Piano	Chiamate API Mensili	Memorie massime	Chiavi API
Gratuito	1,000	100	2
Starter	50,000	5,000	3
Plus	500,000	50,000	5
Pro	2,000,000	Illimitato	10
Enterprise	Illimitato	Illimitato	100

Quando superi il tuo limite di frequenza, l'API restituisce una risposta 429 Too Many Requests .

Codici di Errore

Codice	Descrizione
`200`	Successo
`400`	Richiesta errata - Parametri mancanti o non validi
`401`	Non autorizzato - Chiave API non valida o mancante
`429`	Troppe richieste - Limite di frequenza superato
`500`	Errore interno del server - Qualcosa e andato storto

Sicurezza e Governance

Sicurezza dei dati

✓Crittografia a riposo: Tutti i dati crittografati con AES-256
✓Crittografia in transito: TLS 1.3 per tutte le connessioni
✓Isolamento tenant: Separazione completa dei dati tra account

Gestione chiavi API

✓Rotazione chiavi: Ruota le chiavi in qualsiasi momento dal pannello
✓Scadenza chiavi: Scadenza automatica dopo 90 giorni (configurabile)
✓Monitoraggio utilizzo: Monitora l'utilizzo per chiave in tempo reale

Conservazione ed eliminazione dati

✓Esporta: Esporta tutti i tuoi dati in qualsiasi momento tramite API o pannello
✓Eliminazione: Eliminazione permanente senza conservazione dopo 30 giorni
✓GDPR/CCPA: Piena conformita con i diritti del soggetto dei dati

SDK

Python

bash

pip install seizn

python

from seizn import Seizn

client = Seizn(api_key="your_api_key")

# Add memory
client.add("User prefers dark mode")

# Search
results = client.search("preferences")

# Extract from conversation
client.extract(conversation="...")

JavaScript

bash

npm install seizn

javascript

import { Seizn } from 'seizn';

const client = new Seizn({ apiKey: 'your_api_key' });

// Add memory
await client.add('User prefers dark mode');

// Search
const results = await client.search('preferences');

// Extract from conversation
await client.extract({ conversation: '...' });

MCP Server — Every Editor, One Memory

The Seizn MCP Server (seizn-mcp) bridges your Seizn memories to AI coding assistants via the Model Context Protocol. 40+ tools, MCP Resources, webhooks, OAuth device flow, and multi-editor config sync — all in one package.

bash

# Install globally or use npx
npx seizn-mcp@latest

# Or add to Claude Code settings (~/.claude/settings.json)
{
  "mcpServers": {
    "seizn": {
      "command": "npx",
      "args": ["-y", "seizn-mcp@latest"],
      "env": { "SEIZN_API_KEY": "your-api-key" }
    }
  }
}

Supported Editors

> Claude Code — native MCP
> Cursor — native MCP
> Windsurf — native MCP
> Cline — native MCP
~ GitHub Copilot — via config sync
~ Aider — via config sync
~ OpenAI Codex — via config sync

Key Features

> 40+ MCP Tools — memories, knowledge graph, profile, webhooks, config sync
> MCP Resources — seizn://memories/recent, seizn://profile, seizn://context/{format}
> OAuth Device Flow — browser auth, no API key copy
> Auto Context — detects project from package.json, pyproject.toml, Cargo.toml
> UTF-8 Support — Korean, Japanese, Chinese, Arabic and 100+ languages

Multi-Editor Config Sync

Seizn exports your memories as editor-specific configuration files. Your AI preferences follow you across every tool.

File	AI Tool	Method
CLAUDE.md	Claude Code	MCP + File
AGENTS.md	OpenAI Codex	File Sync
.cursor/rules	Cursor	MCP + File
.windsurfrules	Windsurf	MCP + File
.github/copilot-instructions.md	GitHub Copilot	File Sync
.clinerules	Cline	MCP + File
CONVENTIONS.md	Aider	File Sync

OAuth Device Flow

No more copying API keys. The MCP server supports RFC 8628 Device Authorization Grant for browser-based authentication.

Run auth_login tool

Enter code ABCD-1234 in browser

Token saved to ~/.seizn/

Zero-copy auth: The device flow generates a human-readable code, opens your browser, and saves credentials automatically. Works with any terminal or SSH session.