Vai al contenuto
Sviluppatori

Collega Reaktive ai sistemi che usi già.

Un’API con chiave per utente di servizio, documentata in OpenAPI 3.1: il tuo gestionale avvia le automazioni e legge l’esito, con il costo in euro per ogni corsa.

Stesse regole dell’interfaccia: «non trovato» fuori dalla tua organizzazioneNessun costo per l’API: paghi solo le azioniAudit di ogni scrittura

Il flusso di un’integrazione

Il tuo sistema avvia, una persona approva, il risultato torna indietro.

Il tuo sistema

  • Gestionale: nuovo ordine
  • CRM: nuovo contatto
  • Portale interno: un pulsante

Reaktive

  • Automazione: i passi
  • Agente: controlla e scrive
  • Approvazione: una persona decide

Risultato

  • Stato e costo in euro della corsa
  • File Word, Excel, PDF
  • Email inviata, foglio su Drive

Di nuovo nel tuo sistema

  • Ordine aggiornato con il documento
  • Contatto con il dossier
  • Costo riconciliato nel controllo di gestione
Nessun dato esce senza un passo esplicito: le email e le scritture su Drive aspettano l’approvazione; il tuo sistema riceve solo ciò che la corsa ha prodotto.
Cosa fai dall’API

Le stesse azioni dell’area di lavoro, dal tuo software.

Un elenco chiuso di rotte, documentate una per una. Ciò che non è nell’elenco non si può fare con una chiave.

Avvia un’automazione

Con i dati di ingresso del tuo sistema: parte la versione attiva, in coda come dal pulsante «Esegui».

  • POST/api/workflows/{id}/runs
  • GET/api/workflows/{id}/tasks/{taskId}

Segui le corse e scarica i file

Stato, durata, costo in euro e file prodotti di ogni corsa; annulla quelle in coda.

  • GET/api/runs · /api/runs/{id}
  • GET/api/runs/{id}/files/{fileId}

Parla con un agente

Crea la chat, invia il messaggio, leggi la risposta mentre arriva, allega file. Il turno costa come dall’interfaccia.

  • POST/api/chats · /api/chats/{id}/messages
  • POST/stream · /api/chats/{id}/files

Approvazioni

Leggi gli invii in attesa e decidi, se ne hai il diritto: anche da un tuo pannello interno.

  • GET/api/approvals · /api/approvals/{id}
  • POST/api/approvals/{id}

Agenti e utilizzo

Elenco e scheda degli agenti; la spesa per persona, agente e automazione, per riconciliare i costi.

  • GET/api/agents · /api/agents/{id}
  • GET/api/usage

Team e chiavi

Con lo scope di amministrazione: inviti al team e chiavi utente, che restano in attesa finché il Proprietario le approva.

  • GET/api/team · POST /api/team
  • GET/api/api-keys · POST /api/api-keys
Come si integra un gestionale

Tre passi, e il tuo sistema lavora con Reaktive.

  1. Un utente di servizio

    Nel Team crei «Gestionale» come utente di servizio, con il suo tetto di spesa: le azioni sono attribuite e limitate come per una persona.

  2. Una chiave approvata

    L’utente di servizio crea la chiave rk_…; il Proprietario la approva. La chiave si vede una volta sola.

  3. Chiamate con la chiave

    Authorization: Bearer rk_… e una Idempotency-Key per non avviare due volte la stessa corsa se la rete cade.

Le prove dal browser («Prova la chiamata») sono nella pagina Sviluppatori dell’area di lavoro, dopo l’accesso: sono chiamate reali e consumano credito.

# 1. Il gestionale avvia l’automazione per il nuovo ordine
curl -X POST \
  https://reaktive.cloud/api/workflows/<id>/runs \
  -H "Authorization: Bearer rk_…" \
  -H "Idempotency-Key: ordine-10492" \
  -H "Content-Type: application/json" \
  -d '{"source":"active","input":{"ordine":"10492"}}'
# 202 Accepted
{"taskId":"5b7d9f1a-…","status":"queued"}
# 2. Legge lo stato finché terminal è true
curl -H "Authorization: Bearer rk_…" \
  https://reaktive.cloud/api/workflows/<id>/tasks/5b7d9f1a-…
{"task":{"status":"done"},"run":{"id":"4e6a8c0b-…","outcome":"completed","costEur":"0.004120000000"},"terminal":true}
# 3. Scarica i file prodotti dalla corsa
curl -H "Authorization: Bearer rk_…" \
  https://reaktive.cloud/api/runs/4e6a8c0b-…
Riferimento OpenAPI

Ogni rotta documentata, con esempi, in italiano e inglese.

Generato dallo stesso documento OpenAPI 3.1 che la piattaforma usa nei test: se cambia l’API, cambia la pagina. Qui in sola lettura; le prove dopo l’accesso.

Le modifiche additive compaiono nella sezione «Novità»; una modifica incompatibile arriva solo con un nuovo prefisso, annunciato 90 giorni prima.

Sicurezza e limiti

Regole chiare, uguali per tutti.

Due scope

Utente e amministrazione. Il ruolo della persona resta il limite: una chiave non fa più di chi l’ha creata, e non ha mai poteri di piattaforma.

Isolamento

Un oggetto di un’altra organizzazione risponde 404, come dall’interfaccia. Le chiavi sono conservate solo come impronta.

Limiti per chiave

600 richieste e 60 avvii al minuto; oltre, 429 con Retry-After.

Idempotenza

Stessa Idempotency-Key e stesso corpo entro 24 ore: stessa risposta, nessuna doppia corsa.

Errori a codice

{error, message, details}, con il messaggio nella lingua di Accept-Language.

Audit

Ogni scrittura con origine «api»; «ultimo uso» su ogni chiave.

Costi

Nessun canone per l’API: ogni corsa o turno costa come dall’interfaccia, dentro il tetto dell’utente di servizio.

Versione

La versione 1 è implicita in /api/…; modifiche incompatibili solo con un nuovo prefisso, annunciate 90 giorni prima.

Esempi di interconnessione

Tre modi di collegare i sistemi aziendali.

Meccanismi veri, dati di esempio.

Gestionale (ERP)

A ogni nuovo ordine il gestionale avvia «Verifica fornitore e bozza di conferma»: l’agente controlla il fornitore sul web, prepara la bozza di email e chiede l’approvazione; il gestionale legge l’esito e il documento.

  • Avvio con dati di ingresso
  • Esito e file
  • Approvazione

CRM

Per ogni nuovo contatto il CRM avvia la ricerca sull’azienda (sito, notizie, bandi vinti) e riceve il dossier, che l’automazione salva anche nella cartella Drive del commerciale.

  • Ricerca web
  • Drive
  • Costo per corsa

Portale interno

Un pulsante «Rassegna straordinaria» nell’intranet avvia l’automazione con il tema scelto e mostra i file prodotti quando la corsa finisce; le approvazioni restano a chi ne ha il diritto.

  • Avvio
  • Stato della corsa
  • File
In arrivo

Cosa entra nell’elenco appena è pronto e provato.

Webhook di uscita firmati

Reaktive chiama il tuo sistema a fine corsa.

In arrivo

Avvio con stream

Gli eventi della corsa mentre accade.

In arrivo

Agenti da API

Creazione e modifica con la chiave di amministrazione.

In arrivo

Chat senza stream

Una sola chiamata, risposta completa.

In arrivo
Per integratori

Vuoi vederla sul tuo caso?

Una demo tecnica di 30 minuti: avviamo un’automazione dal tuo sistema e leggiamo l’esito insieme.