Skip to main content

Autenticazione

L’API VoiceCheap utilizza chiavi API per l’autenticazione. Tutte le richieste API devono includere la tua chiave API nell’intestazione x-api-key.

Ottenere la tua chiave API

1

Accedi a VoiceCheap

Vai su app.voicecheap.ai e accedi al tuo account.
2

Vai alla pagina API

Vai alla pagina API su app.voicecheap.ai/page-api.
3

Genera chiave API

Fai clic su Crea nuova chiave e assegna un nome alla tua chiave. La tua chiave API completa verrà visualizzata una sola volta: copiala e conservala in modo sicuro immediatamente.
Importante: salva subito la tua chiaveLa tua chiave API completa viene visualizzata solo una volta al momento della creazione. Dopo aver chiuso la finestra modale, vedrai solo una versione mascherata (vc_abc...xyz). Se perdi la tua chiave, dovrai eliminarla e crearne una nuova.

Limiti della chiave API

  • Puoi creare un massimo di 5 chiavi API per account
  • Ogni chiave può essere denominata per una facile identificazione (ad es. “Produzione”, “Sviluppo”)
  • Le chiavi possono essere eliminate in qualsiasi momento dalla pagina API

Utilizzo della tua chiave API

Includi la tua chiave API nell’intestazione x-api-key con ogni richiesta:

Requisiti

È richiesto un abbonamento a pagamentoL’accesso all’API richiede un abbonamento a pagamento attivo. Gli account gratuiti non possono utilizzare l’API. Se tenti di utilizzare l’API senza un abbonamento valido, riceverai un errore 403 Forbidden.

Sicurezza della chiave API

Mantienila segreta

Non esporre mai la tua chiave API nel codice lato client, in repository pubblici o in qualsiasi posizione accessibile pubblicamente.

Usa variabili d'ambiente

Memorizza la tua chiave API in variabili d’ambiente o in un gestore di segreti sicuro.

Ruota regolarmente

Ruota periodicamente le tue chiavi API, specialmente se sospetti che possano essere state compromesse.

Monitora l'utilizzo

Tieni traccia del tuo utilizzo dell’API per rilevare eventuali accessi non autorizzati.

Risposte di errore

Se l’autenticazione fallisce, riceverai uno dei seguenti errori:

Esempio di risposta di errore