Vai al contenuto

Sviluppatori · API · Webhook · MCP

Tutto quello che fa l’interfaccia, lo fa l’API.

Le operazioni sono esposte tramite API documentata, gli eventi arrivano via webhook firmato e un server MCP permette ai tuoi agenti IA di lavorare con la tua mediateca.

Prenota una demo

Riferimento OpenAPI — Condiviso durante la demo

Mappa delle risorse · REST v1

/assets
Il fondo completo: metadati, versioni, diritti, stati.
/search
Ricerca semantica cross-lingua con filtri strutturati.
/shares
Portali di condivisione e relative accettazioni legali.
/live-links
Link dinamici: programmazione, cessioni, telemetria.
/workflows
Processi BPMN: istanze, attività, storico.

Auth: token con scope · limiti d’uso documentati · paginazione a cursore

GET /api/v1/search
GET /api/v1/search?q=famiglie+che+sciano+tramonto&rights=valid
Authorization: Bearer lz_live_····
200 OK
{
  "hits": [
    {
      "id": "ast_4471",
      "type": "image",
      "caption": {
        "en": "Family skiing at sunset",
        "es": "Familia esquiando al atardecer",
        "fr": "Famille à ski au coucher du soleil",
        "it": "Famiglia sugli sci al tramonto"
      },
      "tags": ["inverno", "famiglia", "sci"],
      "rights": {
        "status": "valid",
        "until": "2027-03-01",
        "credit": "© Nome del fotografo"
      },
      "rendition_url": "https://cdn.lienzio.com/…/post-social"
    }
  ],
  "total": 128
}

Webhook

Gli eventi vengono da te.

Firma HMAC-SHA256 su ogni consegna, tentativi esponenziali e pannello delle consegne fallite.

  • asset.published
  • asset.blocked
  • rights.expiring
  • ingest.completed
  • share.accepted
  • livelink.swapped

MCP

Il tuo assistente aziendale, dentro la mediateca.

Collega un assistente IA compatibile con MCP: cerca, crea collezioni e condividi — con i permessi di ogni utente e un audit completo.

tools:

search_assets · get_asset · get_rendition_url · create_share · list_collections

«Trova 20 foto invernali con diritti validi per la Francia e condividile con l’agenzia FR»

search_assets → create_share · registrato nel log di audit

Chiedi l’accesso all’API durante la demo.

Ripercorriamo il riferimento con il tuo caso d’uso e ti diamo un token di prova perché il tuo team lo metta alla prova.

Prenota una demo