Passa al contenuto principale

API per sviluppatori

La piattaforma offre un flusso API user-facing per gli agenti. Dall'area API Keys puoi creare credenziali, copiare l'identificatore dell'agente e scaricare la specifica OpenAPI.

Cosa puoi fare​

  • Creare API key per applicazioni e servizi esterni
  • Modificare i metadati delle API key come nome visibile e domini consentiti
  • Eliminare API key quando non servono piu'
  • Copiare l'Agent ID usato da integrazioni e richieste API
  • Scaricare la OpenAPI spec per strumenti LLM, generazione SDK o integrazioni custom

Cosa ti serve​

Prima di usare le API, assicurati di avere:

  • Accesso all'agente nella piattaforma
  • I permessi per aprire l'area Developers
  • Almeno una API key attiva per l'accesso programmatico
  • L'Agent ID corretto dell'agente che vuoi chiamare

Credenziali API​

Le API key si creano nella pagina Developers > API Keys di uno specifico agente.

Quando crei una chiave puoi definire facoltativamente:

  • Un nome per aiutare il team a riconoscerla
  • Un elenco di domini consentiti per limitare dove la chiave puo' essere usata

In seguito puoi modificare o eliminare la stessa chiave direttamente dalla piattaforma.

Agent ID​

La pagina API Keys mostra anche l'Agent ID dell'agente selezionato.

Usa questo identificatore quando un'integrazione, uno script o un flusso API ti chiede di specificare quale agente deve gestire la richiesta.

Documentazione e schema​

Dalla pagina API Keys la piattaforma espone questa risorsa pubblica:

  • OpenAPI spec production: https://ai-api.original.land/docs/openapi.yaml

Il file OpenAPI e' particolarmente utile quando vuoi:

  • Controllare endpoint disponibili e schemi delle richieste
  • Generare client code o SDK interni
  • Passare lo schema a strumenti developer basati su LLM
suggerimento

Se parti dalla piattaforma, apri prima Developers > API Keys. Da quella pagina ottieni API key, Agent ID e accesso rapido al download della OpenAPI spec.

warning

Questa pagina documenta solo il flusso API user-facing. Non documenta API interne di piattaforma, infrastruttura privata o endpoint di configurazione riservati.