Termini di utilizzo di API e MCP
I presenti Termini disciplinano l’accesso programmatico a Valkiria tramite l’API pubblica v1, il server MCP e le app OAuth. Mantieni segrete le tue chiavi, rispetta i limiti di richieste e gli ambiti autorizzati e ricorda che le operazioni di scrittura seguono le stesse regole di approvazione dell’app.
1. Ambito di applicazione
1.1 I presenti Termini di API e MCP integrano i /terms e si applicano all’API pubblica v1 di Valkiria, al server Model Context Protocol (MCP), al server di autorizzazione OAuth 2.1 per app di terzi e a qualsiasi chiave API, token e documentazione da noi forniti (complessivamente, l’“API”).
1.2 L’utilizzo dell’API resta inoltre soggetto alla /legal/acceptable-use, ai /legal/ai-terms e, per i dati personali, al /legal/dpa.
2. Disponibilità
2.1 Le chiavi API per l’API pubblica v1 sono incluse nel piano Pro e negli accordi con agenzie in cui sono attivate per l’account le chiavi per singolo cliente. Gli altri piani non includono chiavi API.
2.2 Possiamo modificare, versionare o dismettere endpoint e strumenti MCP. Ci impegniamo ad annunciare in anticipo le modifiche non retrocompatibili degli endpoint generalmente disponibili, salvo quando una modifica immediata sia necessaria per ragioni di sicurezza o di legge.
3. Chiavi API
3.1 Le chiavi API (prefisso vk_live_) sono trasmesse come token Bearer. Conserviamo solo l’hash di ciascuna chiave, pertanto una chiave smarrita non può essere visualizzata di nuovo: creane una nuova e revoca quella precedente.
3.2 Ogni chiave reca degli ambiti (scope), ad esempio reports:read, campaigns:read, campaigns:write, analytics:read, leads:read, rules:read, rules:write, content:read, content:write, smm:read, seo:read, aso:read, ai:generate e portal_users:manage. Utilizza gli ambiti più ristretti di cui hai bisogno.
3.3 Le chiavi possono essere limitate allo spazio di lavoro di un solo cliente. Una chiave limitata a un cliente non può essere utilizzata per accedere ad altri clienti o alle funzioni per i partner.
3.4 Sei responsabile di ogni attività svolta con le tue chiavi fino alla loro revoca.
4. App OAuth e client MCP
4.1 Le app di terzi e gli assistenti IA si collegano tramite OAuth 2.1 con registrazione dinamica dei client. È supportato esclusivamente il flusso del codice di autorizzazione con PKCE (S256). I token di aggiornamento vengono rinnovati a ogni utilizzo e possono essere revocati.
4.2 Sono disponibili due ambiti: “read”, che consente la lettura dei dati, e “propose”, che consente solo di creare bozze in pausa e proposte. L’ambito “propose” non attiva mai campagne né aumenta la spesa.
4.3 La persona che autorizza un’app è responsabile della scelta di app di cui si fida. Puoi revocare in qualsiasi momento l’accesso di un’app nelle impostazioni del tuo account.
4.4 Se sviluppi un’app destinata ad altri, devi fornire ai tuoi utenti una descrizione accurata di ciò che l’app fa con i loro dati e non devi richiedere accessi di cui non hai bisogno.
5. Operazioni di scrittura e regole di approvazione
5.1 Le modifiche effettuate tramite l’API o MCP sono soggette alla stessa policy di scrittura delle modifiche effettuate nell’app, compresi il tuo livello di autonomia, i limiti, l’arresto di emergenza e l’obbligo di approvazione umana per cancellazioni, nuova spesa e modifiche irreversibili. Tali regole sono descritte nei /legal/ai-terms.
5.2 Sei responsabile delle conseguenze delle modifiche che effettui o approvi tramite l’API, compresa la spesa pubblicitaria sulle piattaforme collegate.
6. Limiti di richieste e uso corretto
6.1 L’API pubblica, il server MCP e gli endpoint OAuth condividono un limite di 100 richieste al minuto. Possiamo adeguare i limiti per proteggere il Servizio e riporteremo i limiti vigenti nella documentazione.
6.2 Le richieste eccedenti il limite vengono respinte. Non tentare di aggirare i limiti, ad esempio utilizzando più account o più chiavi per un unico carico di lavoro.
7. Utilizzi vietati
- Lo scraping o l’estrazione massiva del Servizio, dei dati di altri clienti o dei nostri contenuti informativi, oltre ai dati del tuo account.
- La rivendita, la concessione in sublicenza o l’offerta a terzi di accesso diretto all’API come servizio autonomo, salvo ai sensi dei /legal/partner-terms o di un accordo scritto.
- Lo sviluppo di un prodotto concorrente copiando i nostri output, prompt o interfacce.
- Il sondaggio, i test di carico o gli attacchi all’API, salvo quanto consentito dalla /legal/security-policy.
- L’utilizzo dell’API per eludere le policy, le approvazioni o i limiti delle piattaforme pubblicitarie.
8. Sicurezza delle chiavi
8.1 Non inserire chiavi e token in repository di codice pubblici, codice lato client o documenti condivisi. Ruotali regolarmente e immediatamente in caso di sospetta esposizione.
8.2 Se una chiave o un token è compromesso, comunicacelo senza indugio a support@valkiria.pro con oggetto “Security”.
9. Sospensione e revoca
9.1 Possiamo sospendere o revocare chiavi, token o registrazioni di app qualora riteniamo ragionevolmente che siano compromessi, utilizzati in violazione dei presenti Termini o che mettano in pericolo il Servizio o altri clienti, oppure ove richiesto dalla legge. Ove possibile, ti comunicheremo il motivo.
9.2 Le chiavi cessano di funzionare quando il tuo piano non include più l’accesso all’API o il tuo account cessa.
10. Esclusione di garanzie
10.1 L’API è fornita alle condizioni di servizio e di responsabilità dei /terms. Non garantiamo una disponibilità ininterrotta; si veda la /legal/support-policy.