Guida rapida: ottieni la tua chiave API

La tua area personale: un unico saldo condiviso, fino a 3 chiavi API, codici dei marketplace e consumo per richiesta. Nel bot Telegram e su app.oneprovider.dev.

Come funziona

• Saldo e chiavi si trovano nella tua area personale. È la stessa nel bot e sul sito.
• Ricarichi un unico saldo condiviso ed emetti da solo le chiavi API (3 per impostazione predefinita; l'assistenza può alzare il limite). Ogni chiave spende quel saldo entro il proprio limite.
• Una chiave più vecchia viene spostata nell'area personale, con il suo saldo residuo, quando apri il bot.

Apri l'area personale

L'accesso all'area personale e la tua chiave API sono due cose diverse: la chiave API resta la credenziale al portatore per le richieste API, mentre l'accesso serve solo a gestire saldo e chiavi.

Ricarica il saldo

1. Bot: «Area personale» → «Ricarica il saldo». Sito: «Saldo» → «Ricarica».
2. Scegli un pacchetto o un importo a scelta da $100 a $5000 e un metodo di pagamento: crypto, carte internazionali / Apple Pay / Google Pay, SBP / QR. L'importo finale e le commissioni sono mostrati prima del pagamento.
3. Paga con il link o con la richiesta di pagamento. Il saldo viene accreditato in automatico, di solito in 1–3 minuti.

• SBP/QR. Il cliente paga una commissione del 3,5%; OneProvider copre un altro 3,5%.
• Crypto. Si applica una commissione del provider del 3%, più la commissione di rete a carico del cliente.

I prezzi dei pacchetti sono nella pagina dei prezzi ; i metodi di pagamento sono in metodi di pagamento . Il saldo non scade e non ci sono abbonamenti né addebiti automatici. Hai pagato ma il saldo non è cambiato? Invia la ricevuta a @Oneproviderhelpbot .

Codice del marketplace

Hai comprato su G2A, Plati, G2G o simili? Il tuo ordine è arrivato con un codice come OP-XXXX-XXXX. Bot: «Altro» → «Attiva codice». Sito: «Saldo» → campo «Codice OP». L'importo dell'ordine va direttamente sul saldo dell'area personale; la chiave la emetti tu (passaggio successivo).

Emetti una chiave

1. Bot: «Area personale» → «Emetti chiave». Sito: «Chiavi» → «Emetti una chiave».
2. Imposta un nome (per esempio, il client), un limite di spesa (oppure «nessun limite») e una durata: fino a 90 giorni, prorogabile in seguito.
3. Copia subito la chiave: la chiave completa viene mostrata una sola volta, poi solo con «Mostra» dopo aver effettuato di nuovo l'accesso.

Usa una chiave separata per ogni client o progetto: vedi chi spende cosa e puoi fermare una chiave senza toccare le altre. Per impostazione predefinita puoi avere 3 chiavi (l'assistenza può alzare il limite su richiesta); se hai raggiunto il limite, elimina una chiave: il suo saldo è già nell'area personale, non si perde nulla.

Formato della chiave

Le chiavi sono sk- seguito da 64 caratteri esadecimali minuscoli, per esempio sk-50e20199...f837fca1. Trattane il valore come opaco: all'interno non c'è nulla di interpretabile.

Dove conservarla

• Sviluppo locale: una variabile d'ambiente nell'rc della tua shell, oppure un file .env incluso in .gitignore.
• CI: l'archivio dei segreti della piattaforma (GitHub Actions secrets, variabili di GitLab CI e simili).
• Produzione: un vero gestore di segreti: 1Password, AWS Secrets Manager, Doppler, Vault.
• App mobile / browser: mai. La chiave deve stare dietro un proxy server che controlli tu.

Consumo e saldo

La pagina «Consumo» dell'area personale elenca ogni richiesta con modello, token e prezzo, filtrabile per chiave. Anche l'API restituisce il saldo: GET /v1/dashboard/balance .

Bonus

Il bonus di benvenuto e il bonus sulla prima ricarica sono offerte promozionali: possono essere disponibili per un periodo limitato, non si possono prelevare e non sono rimborsabili (vedi i Termini ). Le offerte disponibili sono mostrate nell'area personale; quando un'offerta scade, il bonus non può più essere richiesto.

Referral

La scheda «Referral» dell'area personale contiene il tuo link personale. Invita altre persone e ricevi una ricompensa alle condizioni mostrate nell'area personale. Registrarsi tramite il proprio link non dà alcuna ricompensa.

Unire le aree personali

Se hai due aree personali (per esempio una in Telegram e una sul sito), scrivi a @Oneproviderhelpbot : dopo aver dimostrato di essere il titolare di entrambe, le uniamo e saldo e chiavi finiscono in un'unica area personale.

Pausa, eliminazione, fughe di chiavi

• Pausa ferma una chiave senza eliminarla; «Riattiva» la riaccende.
• Elimina disattiva subito la chiave e non si può annullare. Il saldo resta nell'area personale.

Attivazione di un codice del marketplace: domande

Dove inserisco il codice OP-XXXX-XXXX?

Nel bot Telegram scegli «Altro» → «Attiva codice». Su app.oneprovider.dev apri «Saldo» e usa il campo «Codice OP». L'importo dell'ordine viene aggiunto al saldo della tua area personale; poi emetti una chiave nel passaggio «Emetti una chiave» qui sopra.

Attivo su redeem.oneprovider.dev. Quale scheda uso?

«Nuovo utente» crea una nuova chiave dal codice e dal nome utente o dall'email del tuo ordine. «Ho già una chiave» aggiunge il saldo del codice a una vecchia chiave sk- che hai già. Un secondo codice sulla stessa email non crea un'altra chiave nuova: usa «Ho già una chiave» oppure un'altra email.

Non ho copiato la chiave dopo l'attivazione

Inserisci di nuovo lo stesso codice nella pagina di attivazione: mostra di nuovo la chiave dietro un clic per rivelarla. Le chiavi emesse nell'area personale si possono mostrare con «Mostra» dopo aver effettuato di nuovo l'accesso.

«Non abbiamo trovato questo codice»

Controlla che non ci siano errori di battitura (il codice è OP- seguito da due gruppi di quattro caratteri). Anche un codice revocato o di qualcun altro non viene trovato. Riprova da un altro browser, poi scrivi all'assistenza indicando l'ID dell'ordine sul marketplace.

Posso ottenere un rimborso per un codice?

Di solito tramite una contestazione sul marketplace dove l'hai comprato. Le nostre regole sono nella Politica di rimborso .