Come assegnare numeri fax utilizzando l'API di Fax.Plus?

Panoramica

Questa guida spiega come assegnare numeri fax agli utenti aziendali tramite l'API di Fax.Plus. Imparerai a elencare i membri aziendali, ad assegnare numeri a utenti specifici e a revocare le assegnazioni dei numeri quando necessario.

Prerequisiti

• Un account Fax.Plus Enterprise attivo
• Credenziali API valide
• Due o più numeri fax nel tuo account

Guida passo passo

1. Elenca i membri aziendali
   Innanzitutto, recupera un elenco di tutti i membri del tuo account aziendale. Questo endpoint è accessibile solo dagli account amministratore.
   GET /v3/accounts

{
"members": [
{
"account_data": {
"company_name": "Company name",
"default_file_type": "pdf",
"save_history": true
},
"account_type": "corporate_admin",
"email": "John@sample.com",
"lastname": "Smith",
"status": "active",
"uid": "7724157c0974440293e45877c57f0703"
}
]
}Importante: Annota lo UIDdel membro a cui vuoi assegnare il numero. Ti servirà nel passaggio successivo.
   Scopri di più: Elenca i membri aziendali - Fax.Plus API
2. Assegna un numero all'utente
   Una volta ottenuto lo UIUdell'utente, puoi assegnargli un numero fax utilizzando il seguente endpoint:
   POST /v3/accounts/self/numbers/{number}
   Corpo della richiesta:
   {
"assigned_to": "<uid>"
}Sostituisci {number} nell'URL con il numero fax effettivo che vuoi assegnare, e il valore di assigned_tocon lo UIUdell'utente.
   Scopri di più: Assegna numero - Fax.Plus API
3. Revoca assegnazione numero
   Se devi rimuovere l'assegnazione di un numero da un utente, utilizza questo endpoint:
   DELETE /v3/accounts/{user_id}/numbers/{number}
   Scopri di più: Revoca numero - Fax.Plus API
   Parametri:
   
   • user_idID dell'utente da cui revocare il numero
   • numberNumero fax da rimuovere dall'utente

Risoluzione dei problemi

Problemi comuni e soluzioni

1. Errore 403 Forbidden
   
   • Causa: permessi insufficienti o account non amministratore
   • Soluzione: verifica di utilizzare un account amministratore e di avere gli ambiti API richiesti
2. Errore 404 Not Found
   • Causa: ID utente o numero fax non validi
   • Soluzione: controlla nuovamente che l'ID utente e il numero fax siano corretti
3. Errore 400 Bad Request
   • Causa: formato della richiesta non valido o tentativo di rimuovere un numero da un amministratore
   • Soluzione: verifica il formato della richiesta e assicurati di non tentare di rimuovere numeri dagli account amministratore