Vai al contenuto

PiattaformaGoverna

Chiavi API

Le tue integrazioni leggono i dati, senza password

Emetti una chiave per un'integrazione e lascia che legga progetti, dataset e righe con l'API REST pubblica. L'API è in sola lettura: non modifica nulla.

Chiavi API
  • Esportazione notturnaAttiva

    mvk_a1b2c3d4e5f60718_••••••••

    Lettura dataset · ultimo utilizzo 06:02

  • Report esternoRevocata

    mvk_9e8d7c6b5a403122_••••••••

    Lettura impostazioni

Inviala nell'intestazione X-Api-Key.

Esempio illustrativo

Accesso programmatico, con i freni giusti

  • Sola lettura

    L'API pubblica espone l'azienda, i progetti, i dataset e le loro righe. Non c'è modo di scrivere.

  • Permessi propri

    Ogni chiave ha i suoi permessi, scelti tra quelli che possiedi tu. Non agisce come la persona che l'ha emessa.

  • Scade sempre

    Ogni chiave ha una scadenza, da 1 a 3650 giorni (90 se non la cambi). Si revoca quando vuoi e smette subito di funzionare.

  • Mostrata una sola volta

    La chiave completa compare soltanto alla creazione e Muvia ne conserva solo l'impronta: se la perdi, ne emetti un'altra.

Dalla chiave alla prima richiesta

  1. 01

    Emetti la chiave

    Dai un nome, scegli i permessi e la durata. Serve il permesso di amministrazione.

  2. 02

    Inviala a ogni richiesta

    Nell'intestazione X-Api-Key. Il contratto OpenAPI dell'API è pubblicato e consultabile.

  3. 03

    Tieni d'occhio l'uso

    L'elenco mostra stato, scadenza e ultimo utilizzo di ogni chiave, e puoi revocare in blocco quelle emesse da una persona.

In dettaglio

Metodo
Solo lettura: nessuna scrittura.
Formato
Le chiavi iniziano con mvk_, riconoscibili in un log o da uno strumento che cerca segreti.
Isolamento
Una chiave vede soltanto i dati della propria azienda.
Limiti
Richieste limitate per chiave e per azienda; oltre il limite l'API risponde 429 con Retry-After.
Errori
Risposte JSON con un codice stabile.

Domande frequenti

No. L'API pubblica è in sola lettura.

Portaci una domanda a cui oggi non sai rispondere.

Partiamo da una domanda vera della tua azienda e ti mostriamo il percorso dalla fonte al cruscotto, con i tuoi sistemi e non con quelli di una demo.