Come acquistare numeri fax utilizzando l'API di Fax.Plus

Panoramica

Questa guida ti spiegherà come acquistare numeri fax tramite l'API di Fax.Plus. Imparerai come controllare il tuo saldo, trovare i numeri disponibili e completare il processo di acquisto.

Prerequisiti

• Un account Fax.Plus Enterprise attivo
• Credenziali di accesso all'API
• Saldo dell'account sufficiente per l'acquisto

Guida passo dopo passo

1. Controlla il saldo del tuo account
   Prima di iniziare il processo di acquisto, verifica di disporre di fondi sufficienti nel tuo account. L'API di Fax.Plus utilizza esclusivamente il saldo del tuo account per gli acquisti.
   GET /v3/shop/balance
   Esempio di risposta:
   {
"amount": 100,
"currency": "USD"
}Scopri di più: Ottieni il saldo dell'account - API di Fax.Plus
   

   Suggerimento: Assicurati che il tuo saldo sia sufficiente a coprire il costo del numero che desideri acquistare. Se devi aggiungere fondi, visita app.fax.plus

2. Visualizza i paesi disponibili
   GET /v3/shop/numbers/countries
   Scopri di più: Elenco paesi - API di Fax.Plus
   Attualmente, i numeri fax tramite l'API di Fax.Plus sono disponibili in:
   
   • 🇺🇸 Stati Uniti
   • 🇨🇦 Canada
3. Trova le aree disponibili
   Dopo aver selezionato un paese, puoi visualizzare le aree geografiche disponibili in cui è possibile acquistare numeri fax.
   GET /v3/shop/numbers/countries/{country_code}/areas
   Esempio per le aree negli Stati Uniti:
   GET /v3/shop/numbers/countries/US/areas
   Scopri di più: Elenco aree - API di Fax.Plus
4. Cerca i numeri disponibili
   Cerca numeri fax utilizzando i filtri per paese e area:
   GET /v3/shop/numbers/countries/{country_code}/areas/{calling_code}/numbers
   Esempio di ricerca di numeri a New York (prefisso 212):
   GET /v3/shop/numbers/countries/US/areas/212/numbers
   Scopri di più: Elenco dei numeri disponibili - API di Fax.Plus
5. Acquista un numero
   Una volta trovato il numero desiderato, puoi acquistarlo immediatamente:
   POST /v3/shop/numbers/purchase
   Corpo
   {
"item_id": "<string>"
}Risposta
   {
"number": "<string>"
}
   

Note importanti

• Requisito di saldo: assicurati di disporre di un saldo sufficiente prima di tentare un acquisto.
• Disponibilità geografica: al momento i numeri sono disponibili solo negli Stati Uniti e in Canada.
• Metodo di pagamento: gli acquisti vengono elaborati solo utilizzando il saldo del tuo account.
• Acquisti non riusciti: se il saldo non è sufficiente, l'acquisto non andrà a buon fine.
  
  

Scopri di più: Acquistare un numero - API di Fax.Plus

Risoluzione dei problemi

Problemi comuni e soluzioni

1. Saldo insufficiente
   • Soluzione: aggiungi fondi tramite l'interfaccia web app.fax.plus.
2. Numero non più disponibile
   • Soluzione: i numeri vengono assegnati in tempo reale. Se un acquisto non riesce perché il numero non è più disponibile, esegui una nuova ricerca e prova con un numero diverso.
3. Prefisso non valido
   • Soluzione: verifica il prefisso utilizzando l'endpoint delle aree prima di cercare i numeri.