توثيق API

كل ما تحتاجه لدمج Seizn في تطبيقاتك. أضف ذاكرة دائمة للذكاء الاصطناعي الخاص بك ببضع سطور من التعليمات البرمجية فقط.

البداية السريعة

احصل على مفتاح API الخاص بك من لوحة التحكم، ثم ابدأ بإرسال الطلبات:

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"

المصادقة

تتطلب جميع طلبات API مفتاح API في رأس x-api-key .

bash

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

الأمان: حافظ على سرية مفاتيح API الخاصة بك. لا تكشفها أبدًا في الكود من جانب العميل. استخدم متغيرات البيئة أو وكيل الخادم.

نقاط نهاية API

POST/api/memories

إضافة ذاكرة جديدة إلى مخزن ذاكرة المستخدم.

محتوى الطلب

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

الاستجابة

{
  "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

البحث في الذكريات باستخدام التشابه الدلالي.

معاملات الاستعلام

query-string (required)

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

threshold-number 0-1 (default: 0.7)

namespace-string

الاستجابة

{
  "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

حذف الذكريات بواسطة المعرفات.

معاملات الاستعلام

ids-string (required) - comma-separated

الاستجابة

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

POST/api/extract

استخراج وتخزين الذكريات من محادثة باستخدام AI.

محتوى الطلب

conversation-string (required)

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

auto_store-boolean (default: true)

namespace-string (default: "default")

الاستجابة

{
  "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

الحصول على استجابات مولدة بواسطة AI باستخدام الذكريات ذات الصلة كسياق (RAG).

محتوى الطلب

query-string (required)

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

top_k-number (default: 5)

namespace-string

include_memories-boolean (default: true)

الاستجابة

{
  "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"
}

حدود المعدل

الخطة	Monthly API Calls	الحد الأقصى للذكريات	مفاتيح API
مجاني	1,000	100	2
Starter	50,000	5,000	3
Plus	500,000	50,000	5
Pro	2,000,000	غير محدود	10
المؤسسات	غير محدود	غير محدود	100

عند تجاوز حد المعدل الخاص بك، يرجع API استجابة 429 Too Many Requests .

رموز الخطأ

الرمز	الوصف
`200`	نجاح
`400`	طلب غير صالح - معاملات مفقودة أو غير صالحة
`401`	غير مصرح - مفتاح API غير صالح أو مفقود
`429`	طلبات كثيرة جدًا - تم تجاوز حد المعدل
`500`	خطأ داخلي في الخادم - حدث خطأ ما

الأمان والحوكمة

أمان البيانات

✓التشفير في حالة السكون: جميع البيانات مشفرة بـ AES-256
✓التشفير أثناء النقل: TLS 1.3 لجميع الاتصالات
✓عزل المستأجرين: فصل كامل للبيانات بين الحسابات

إدارة مفاتيح API

✓تدوير المفاتيح: قم بتدوير المفاتيح في أي وقت من لوحة التحكم
✓انتهاء صلاحية المفاتيح: انتهاء تلقائي بعد 90 يومًا (قابل للتكوين)
✓تتبع الاستخدام: راقب استخدام كل مفتاح في الوقت الفعلي

الاحتفاظ بالبيانات والحذف

✓التصدير: قم بتصدير جميع بياناتك في أي وقت عبر API أو لوحة التحكم
✓الحذف: حذف نهائي بدون احتفاظ بعد 30 يومًا
✓GDPR/CCPA: امتثال كامل لحقوق أصحاب البيانات

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.