Comment attribuer des numéros de fax à l'aide de l'API Fax.Plus\u00A0?

Aperçu

Ce guide explique comment attribuer des numéros de fax à des utilisateurs de l'entreprise via l'API Fax.Plus. Vous apprendrez à lister les membres de l'entreprise, à attribuer des numéros à des utilisateurs spécifiques, et à révoquer des attributions de numéros si nécessaire.

Prérequis

• Un compte Fax.Plus Enterprise actif
• Des identifiants API valides
• Au moins deux numéros de fax dans votre compte

Guide étape par étape

1. Lister les membres de l'entreprise
   Tout d'abord, récupérez la liste de tous les membres de votre entreprise. Cet endpoint n'est accessible qu'aux comptes administrateurs.
   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"
}
]
}Important : notez l'UIDdu membre auquel vous souhaitez attribuer le numéro. Vous en aurez besoin à l'étape suivante.
   En savoir plus : List corporate members - Fax.Plus API
2. Attribuer un numéro à l'utilisateur
   Une fois que vous disposez de l'UIUde l'utilisateur, vous pouvez lui attribuer un numéro de fax à l'aide de l'endpoint suivant :
   POST /v3/accounts/self/numbers/{number}
   Corps de la requête :
   {
"assigned_to": "<uid>"
}Remplacez {number} dans l'URL par le numéro de fax que vous souhaitez attribuer, et la valeur de assigned_topar l'UIUde l'utilisateur.
   En savoir plus : Assign number - Fax.Plus API
3. Révoquer l'attribution d'un numéro
   Si vous devez supprimer l'attribution d'un numéro à un utilisateur, utilisez cet endpoint :
   DELETE /v3/accounts/{user_id}/numbers/{number}
   En savoir plus : Revoke number - Fax.Plus API
   Paramètres :
   
   • user_idID de l'utilisateur auquel retirer le numéro
   • numberNuméro de fax à retirer à l'utilisateur

Dépannage

Problèmes courants et solutions

1. Erreur 403 Forbidden
   
   • Cause : permissions insuffisantes ou compte non administrateur
   • Solution : vérifiez que vous utilisez un compte administrateur et que vous disposez des autorisations API requises
2. Erreur 404 Not Found
   • Cause : identifiant utilisateur ou numéro de fax invalide
   • Solution : vérifiez que l'identifiant utilisateur et le numéro de fax sont corrects
3. Erreur 400 Bad Request
   • Cause : format de requête invalide ou tentative de retrait d'un numéro d'un compte administrateur
   • Solution : vérifiez le format de la requête et assurez-vous de ne pas essayer de retirer des numéros de comptes administrateurs