documente/docs

Documentation

Benvenuto nella documentazione di NotebookLM Agent API.

Indice

• API Reference - Documentazione completa delle API (TODO)
• Examples - Esempi di utilizzo (TODO)

Panoramica

NotebookLM Agent API fornisce:

1. REST API per gestire notebook, fonti, chat e generazione contenuti
2. Webhook System per notifiche event-driven
3. AI Skill per integrazione con agenti AI

Endpoint Principali

Notebook Management

• POST /api/v1/notebooks - Creare notebook
• GET /api/v1/notebooks - Listare notebook
• GET /api/v1/notebooks/{id} - Ottenere notebook
• DELETE /api/v1/notebooks/{id} - Eliminare notebook

Source Management

• POST /api/v1/notebooks/{id}/sources - Aggiungere fonte
• GET /api/v1/notebooks/{id}/sources - Listare fonti
• POST /api/v1/notebooks/{id}/sources/research - Ricerca web

Content Generation

• POST /api/v1/notebooks/{id}/generate/audio - Generare podcast
• POST /api/v1/notebooks/{id}/generate/video - Generare video
• POST /api/v1/notebooks/{id}/generate/quiz - Generare quiz
• POST /api/v1/notebooks/{id}/generate/flashcards - Generare flashcard

Webhooks

• POST /api/v1/webhooks - Registrare webhook
• GET /api/v1/webhooks - Listare webhook
• POST /api/v1/webhooks/{id}/test - Testare webhook

Autenticazione

Tutte le richieste API richiedono header X-API-Key:

curl http://localhost:8000/api/v1/notebooks \
  -H "X-API-Key: your-api-key"

Webhook Security

I webhook includono firma HMAC-SHA256 nell'header X-Webhook-Signature:

import hmac
import hashlib

signature = hmac.new(
    secret.encode(),
    payload.encode(),
    hashlib.sha256
).hexdigest()

Risorse

• README - Panoramica progetto
• PRD - Requisiti prodotto
• SKILL.md - Skill per agenti AI
• CONTRIBUTING - Come contribuire