Vai al contenuto
Meirra
API & Sviluppatori
Torna al Conto

Panoramica sviluppatore

La pagina Sviluppatori, nella barra laterale sinistra del tuo account, ti offre tutto il necessario per integrare Meirra nei tuoi strumenti e flussi di lavoro. Genera chiavi API, monitora il tuo utilizzo e accedi alla documentazione della nostra API REST. Che tu stia creando report personalizzati, automatizzando audit SEO o importando dati di lead nel tuo CRM, la pagina Sviluppatori è il tuo punto di partenza.

Gestione chiavi API

Puoi creare, ruotare e revocare chiavi API dalla pagina Sviluppatori. Ogni chiave può essere limitata a endpoint specifici e ricevere un'etichetta descrittiva per una facile identificazione. Raccomandiamo di creare chiavi separate per ogni applicazione o ambiente. Le chiavi vengono mostrate solo una volta al momento della creazione, quindi conservale in modo sicuro. Se una chiave viene compromessa, revocala immediatamente e generane una nuova.

Utilizzo, spesa e limiti

Il tuo utilizzo dell'API viene registrato per ogni richiesta e mostrato nella pagina Sviluppatori: il saldo attuale del portafoglio, la spesa giornaliera e mensile e una suddivisione per endpoint. Ogni chiamata a pagamento viene addebitata sul tuo portafoglio API prepagato al prezzo pubblicato dell'operazione. **Spesa:** Meirra non impone alcun tetto di spesa predefinito sulle chiamate API o MCP. Il tuo portafoglio prepagato è lo stop: quando è vuoto, la chiamata a pagamento successiva restituisce 402 con il codice `INSUFFICIENT_BALANCE` e non si addebita nulla. Ricarica per continuare. **Il tuo limite giornaliero per chiave:** puoi impostare un limite di spesa giornaliero facoltativo su ogni chiave API, e rimuoverlo quando vuoi. Una chiave non ha limiti finché non ne imposti uno, e la sua riga nella pagina Sviluppatori mostra "Limite giornaliero: Nessun limite". Per impostarlo, scegli "Imposta limite" sulla riga della chiave, inserisci un importo e scegli "Salva limite". Per cambiarlo, scegli "Modifica limite"; per rimuoverlo, scegli "Rimuovi limite" e la chiave torna a "Nessun limite". Quando una chiave ha un limite, una chiamata a pagamento a uno strumento MCP che porterebbe la spesa di quella chiave dalle 00:00 UTC oltre il limite viene rifiutata prima di qualsiasi addebito. Il rifiuto ha lo stato 429, `limit` uguale a `daily_spend_cap` e un Retry-After con i secondi che mancano alle 00:00 UTC, quando il limite si azzera (`retry_after_seconds` nel risultato dello strumento). **Email sul ritmo di spesa (in arrivo):** prevediamo di scriverti quando una chiave inizia a spendere molto più in fretta del solito, per suggerirti di impostare un limite. Un'email non blocca mai una chiamata. Ogni chiave ha anche un limite orario di richieste. Se lo superi, ricevi 429 senza `daily_spend_cap`; attendi il tempo indicato da Retry-After e riprova.

SDK e integrazione

Meirra fornisce librerie client ufficiali per i linguaggi più diffusi tra cui JavaScript, Python e PHP. Ogni SDK gestisce autenticazione, firma delle richieste, paginazione e gestione degli errori automaticamente. Puoi installarli tramite npm, pip o composer rispettivamente. Documentazione completa, esempi di codice e registro delle modifiche sono disponibili nel portale sviluppatori. Le librerie della comunità per altri linguaggi sono elencate nella stessa sezione.

Hai bisogno di più aiuto?

Contatta il supporto