Guida rapida all’API GetAPI.ONE: chiave API e prima richiesta
Un percorso completo dalla creazione dell'account e dalla selezione del modello a una chiave API con ambito, configurazione del client e una prima connessione funzionante.
Inizia qui
Per iniziare con GetAPI.ONE, crea un account, scegli un modello e un endpoint supportato, quindi crea una chiave API. Hai già una chiave? Passa direttamente all’esempio Python o Node.js qui sotto. Controlla i prezzi attuali prima di inviare richieste.
Prima di iniziare
- Usare https://www.getapi.one ufficiale ed email accessibile per verifica.
- Decidi se connetterai la CLI Codex, una destinazione Codex compatibile tramite CCSwitch o il tuo client API.
- Preparare gestore password o variabili privato. Mai incollare chiavi reali in issue pubbliche, schermate o repository.
1. Creare e aprire l'account
- Aprire registrazione, scegliere utente, password di 8–20 caratteri ed email.
- Richiedere e inserire il codice, leggere e accettare Contratto utente e Informativa privacy collegati, quindi creare account.
- Accedere con utente/email e password. Il successo apre la panoramica.
2. Controllare saldo, endpoint e modello
- Confermare saldo o pacchetto prima della richiesta fatturabile.
- Scegliere nel catalogo un modello che elenchi l'endpoint del client; non dedurre protocolli dal nome.
- Apri i prezzi in tempo reale immediatamente prima dell'uso. Controlla il modello, il gruppo, la modalità di prezzo e l'unità di fatturazione correnti perché la disponibilità e i prezzi possono cambiare.
3. Creare una chiave API limitata
- Aprire Chiavi API e crearne una con nome che identifichi client o progetto.
- Scegliere gruppo, scadenza e quota adatti. Ampliare restrizioni avanzate solo comprendendo l'accesso necessario.
- Salvare e copiare la chiave dall'elenco a storage privato. GetAPI.ONE mantiene una voce gestibile per ricopiarla in seguito.
4. Collegare un client
Usare solo il percorso del client. Codex usa Responses e base ONE https://www.getapi.one/v1. Un programma diretto deve usare lo specifico endpoint dichiarato senza aggiungere percorsi alla cieca.
5. Verificare e continuare
- Successo significa risposta valida e registro GetAPI.ONE. La sola sintassi locale non prova una chiamata reale.
- Per 401 ricopiare chiave, confermare abilitazione e indirizzo ONE. Per 404 verificare endpoint o base /v1 attesi.
- Per modello assente sceglierne uno disponibile al gruppo e compatibile. Per quota, frequenza, rete o fornitore, conservare ora e ID prima della diagnosi.