Documentazione per sviluppatori

Collega il servizio di licenze

Parti dall’organizzazione e dalle licenze nello spazio di lavoro. Poi collega la tua applicazione tramite API o MCP.

Dalla licenza al contenuto

flowchart LR
    accTitle: Dalla licenza al contenuto
    accDescr: Il cliente legge le condizioni, richiede un’autorizzazione e recupera il contenuto dall’editore.
    A["Legge la licenza"] --> B["Richiede un token"]
    B --> C["L’editore verifica l’accesso"]
    C --> D["Recupera il contenuto"]

Prima di richiedere l’accesso

Una licenza dichiarata resta visibile mentre attende conferma. Possono autorizzare una richiesta solo i diritti confermati, oppure un’offerta gratuita accettata che conceda l’accesso.

Parti dallo spazio di lavoro

Gli editori configurano risorse e condizioni, pubblicano un riferimento sul sito e confermano i diritti dei clienti. Gli acquirenti collegano licenze esistenti, creano credenziali dell’organizzazione e richiedono l’accesso. Una licenza dichiarata richiede la conferma dell’editore prima di abilitare l’accesso.

Una API, disponibile anche tramite MCP

L’API pubblica è l’interfaccia principale. MCP collega gli strumenti AI alla stessa API, senza introdurre regole di licenza diverse. Conserva i segreti sul server, rispetta la scadenza dei token e gestisci esplicitamente i rifiuti. Le credenziali identificano l’organizzazione cliente, non un singolo agente verificato in modo indipendente.

Dalla licenza al contenuto

Appena salvi una licenza, il tuo agente può consultare risorse registrate, utilizzi e stato di verifica tramite MCP o API. Una conferma in attesa resta visibile, ma non autorizza l’accesso. Per un diritto confermato, l’agente richiede un token temporaneo per l’URL e l’uso previsti, poi recupera il contenuto direttamente dall’editore. Una raccolta identifica un perimetro coperto: gli URL dei singoli documenti provengono dal catalogo dell’editore o dal tuo flusso di lavoro.

Che cosa significa un’autorizzazione

Un token permette l’accesso entro il suo ambito e la sua durata. L’editore lo verifica prima di consegnare i contenuti protetti dal proprio server. AssetRouter registra richieste e autorizzazioni, non download riusciti o usi nelle risposte dei modelli. Il pagamento avviene attualmente direttamente all’editore. Una richiesta, un nuovo tentativo o il rinnovo del token non costituiscono automaticamente un nuovo acquisto.

Esportazione e continuità

AssetRouter firma le registrazioni del servizio e consente a ciascuna parte di esportare i propri dati. L’hosting di base non richiede chiavi di firma dell’editore o installazioni di backup locali. Conservazione indipendente, attestazioni temporali esterne e ripristino di emergenza sono servizi opzionali a pagamento da configurare e collaudare in anticipo.