L’API di Kinsta

L’API REST (Application Programming Interface) di Kinsta è uno strumento potente progettato per consentire agli sviluppatori di accedere facilmente al tuo account Kinsta e ai tuoi progetti e interagire con essi. La nostra API offre un modo semplificato ed efficiente per lavorare con la nostra piattaforma, permettendoti di recuperare dati, eseguire azioni e automatizzare le attività in modo efficiente.

​​

Per tutti i dettagli sugli endpoint API disponibili, per scaricare le nostre specifiche OpenAPI e per provare gli endpoint, consulta la nostra guida di riferimento API.

Per entrare in contatto con altri sviluppatori e trovare tutorial approfonditi, consigli e best practice sull’uso dell’API REST di Kinsta, dai un’occhiata alla categoria Kinsta API del forum della Community Kinsta.

Autenticazione e accesso utente (chiave API)

Per utilizzare l’API di Kinsta, devi generare una chiave API per autenticarti e accedere al tuo account tramite l’API. Puoi generare più chiavi API.

I proprietari dell’azienda, gli amministratori azienda e gli sviluppatori azienda possono creare chiavi API. Il livello di accesso all’API dipenderà dai permessi dell’utente. Ad esempio, una chiave API generata da uno sviluppatore dell’azienda non avrà lo stesso accesso di una chiave generata da un proprietario o da un amministratore azienda.

1. In MyKinsta, vai su nome utente > Impostazioni azienda > Chiavi API e clicca su Crea chiave API.
2. Scegli una data di scadenza o imposta una data di inizio personalizzata e il numero di ore entro cui la chiave scadrà.
3. Assegna un nome alla chiave e clicca su Genera.

Quando viene fornita la chiave API, è l’unica occasione in cui potrai vederla. Assicurati di copiarla e conservarla in un posto sicuro.

Se devi revocare l’accesso a una chiave API, clicca su Revoca.

Endpoint API

Con l’API di Kinsta, puoi eseguire le seguenti azioni:

Hosting WordPress

• Ottenere un elenco dei siti WordPress dell’azienda, i dettagli su un sito specifico e i dettagli sull’ambiente di un sito.
• Creare un nuovo sito WordPress, clonare un sito esistente, creare un sito vuoto senza WordPress ed eliminare un sito.
• Creare un nuovo sito di staging, trasferire un ambiente di staging in produzione ed eliminare un ambiente di staging.
• Svuotare la cache di un sito, riavviare e aggiornare il motore PHP, recuperare e aggiornare l’elenco degli indirizzi IP negati.
• Modificare il limite di memoria PHP e il numero di thread PHP per ambiente.
• Modificare il percorso del sito in cui si trovano i file WordPress (comewp-config.php,wp-content,wp-admin ewp-includes).
• Ottenere e aggiornare le regole di redirect.
• Ottenere lo stato SFTP/SSH del sito e abilitarlo o disabilitarlo.
• Ottenere un elenco dei plugin e dei temi del sito e aggiornarli.
• Aggiungi o rimuovere un dominio.
• Svuotare la cache edge e la cache CDN sul sito.
• Ottenere un elenco di account SFTP aggiuntivi, abilitarli, disabilitarli, aggiungerli e rimuoverli.
• Ottenere i dati analitici del sito.
• Ottenere un elenco dei backup del sito e dei backup scaricabili, ripristinare un backup sul sito ed eliminare un backup.
• Ottenere i file di log del sito.

Azienda

• Ottenere un elenco degli utenti dell’azienda, inclusi il loro indirizzo e-mail, il nome completo e un link alla loro foto del profilo.
• Ottenere un elenco delle sedi dei data center disponibili per i siti all’interno dell’azienda.
• Recupera l’elenco delle chiavi API dell’azienda.
• Ottenere i dati dal registro delle attività dell’azienda.

Gestione DNS

• Ottenere un elenco dei domini e dei record DNS del sito.
• Creare, aggiornare ed eliminare i record DNS.

Casi d’uso comuni

Reportistica

Le API possono essere utilizzate per leggere i dati, in modo da poter creare i report personalizzati o integrare i servizi Kinsta nei tuoi sistemi di monitoraggio interni. Ad esempio, se gestisci un’agenzia e utilizzi un’applicazione che elenca tutti i tuoi clienti, puoi usare l’API per elencare tutti i siti WordPress ospitati da Kinsta appartenenti a ciascun cliente.

Attività pianificate

Puoi creare la tua applicazione per pianificare attività notturne che potrebbero influire sulle prestazioni del tuo sito o causare tempi di inattività. Ad esempio, svuotare la cache del sito durante la notte può aiutare a ridurre al minimo i disagi per i visitatori del tuo sito.

Gestione del sito

Utilizzando Node.js con l’API, puoi creare uno Slackbot per la gestione del sito che ti faccia risparmiare tempo e ti aiuti a gestire i siti in modo più efficiente. Puoi utilizzare lo Slackbot per attività come controllare lo stato del sito, svuotare la cache di un sito e riavviare il motore PHP di un sito.

Creazione di siti WordPress

Puoi aggiungere un nuovo sito WordPress o effettuare un’installazione automaticamente utilizzando l’API. Ad esempio, se gestisci un’agenzia e desideri automatizzare il processo di creazione del sito senza dover accedere a MyKinsta ogni volta, puoi utilizzare l’API per creare il sito e installare WooCommerce, Yoast SEO ed Easy Digital Downloads.

Hai anche la possibilità di creare un’installazione WordPress Multisite (is_multisite TRUE) e configurare un’installazione su sottodominio (is_subdomain_multisite TRUE) o sottodirectory (is_subdomain_multisite FALSE).

Per controllare lo stato della creazione del sito, usa l’endpoint Operations.

Verificare lo stato dell’operazione

Per operazioni che potrebbero richiedere molto tempo (ad es. creazione del sito, svuotamento della cache, riavvio di PHP, ecc.), l’API non risponde immediatamente con il risultato. Questo aiuta a prevenire un potenziale blocco del thread del server o un timeout del gateway dovuto a un’operazione che richiede molto tempo.

Per controllare lo stato di un’operazione, usa l’endpoint /operations. Quando avvii un’operazione, la risposta immediata dell’API includerà un operation_id da utilizzare con l’endpoint /operations. Per ulteriori dettagli ed esempi, consulta la guida di riferimento sull’endpoint Operations.

Limiti di frequenza

Per proteggere la nostra API da un sovraccarico di richieste, il numero di richieste al minuto è limitato come segue:

• 120 richieste al minuto per ogni ID azienda identificato dalla chiave API.
• 1000 richieste al minuto per indirizzo IP. Questo limite si applica se hai accesso a più aziende.
• 5 richieste al minuto per la creazione di risorse, ad esempio la creazione di un sito WordPress.

Per vedere lo stato attuale del limite di velocità, controlla le intestazioni RateLimit nella risposta API più recente. Al momento non è possibile aumentare il limite di velocità.

Risoluzione dei problemi

Se effettui una richiesta a un endpoint a cui la tua chiave API non ha accesso, riceverai un messaggio di errore che ti informerà che non hai accesso. Se hai bisogno di accedere a quell’endpoint, un proprietario o un amministratore dell’azienda dovrà generare una chiave API per te.

Riferimento API

Per tutti i dettagli sugli endpoint API disponibili, per scaricare le nostre specifiche OpenAPI e per provare gli endpoint, consulta il nostro riferimento API.