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

Aperçu

Ce guide explique comment attribuer des numéros de fax aux utilisateurs d'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 les affectations de numéros si nécessaire.

Pré-requis

• Un compte Fax.Plus Entreprise actif
• Identifiants API valides
• Deux numéros de fax ou plus dans votre compte

Guide étape par étape

1. Lister les membres de l'entreprise
   Tout d'abord, récupérer une liste de tous les membres de votre compte d'entreprise. Ce point de terminaison est accessible uniquement par les comptes administrateurs.
   GET /v3/accounts

{
"membres": [
{
"account_data": {
"company_name": "nom de la société",
"default_file_type": "pdf",
"save_history": vrai
},
"account_type": "corporate_admin",
"email": "John@sample. om",
"nom_de_famille": "Smith",
"statut": "actif",
"uid": "7724157c0974440293e45877c57f0703"
}
]
}Important : Note sur la UIDdu membre auquel vous voulez assigner le nombre. Vous en aurez besoin à l'étape suivante.
   En savoir plus: Lister les membres de l'entreprise - API Fax.Plus
2. Assign a number to the user
   Once you have the user's UIU, you can assign a fax number to them using the following endpoint:
   POST /v3/accounts/self/numbers/{number}
   Request body:
   {
"assigned_to": "<uid>"
}Replace {number} in the URL with the actual fax number you want to assign, and the assigned_tovalue with the user's UIU.
   Learn more: Assign number - Fax.Plus API
3. Révoquer le nombre d'assignation
   Si vous avez besoin de supprimer un nombre d'assignation à un utilisateur, utiliser ce point de terminaison :
   SUPPRIMER /v3/accounts/{user_id}/numbers/{number}
   En savoir plus : Révoquer le numéro - Fax. Paramètres de lus API
   :
   
   • user_idID de l'utilisateur pour révoquer le numéro de
   • numéronuméro de télécopie à supprimer de l'utilisateur

Dépannage

Problèmes et solutions courants

1. 403 Erreur Interdite
   
   • Cause: Insufficient permissions or non-admin account
   • Solution : Vérifiez que vous utilisez un compte administrateur et que vous avez les portées API requises
2. 404 Erreur introuvable
   • Cause: Invalid user ID or fax number
   • Solution : Vérifiez deux fois l'ID utilisateur et le numéro de fax sont corrects
3. Erreur de requête incorrecte 400
   • Cause: Invalid request format or attempting to remove a number from admin
   • Solution : Vérifiez le format de la requête et assurez-vous que vous n'essayez pas de supprimer des numéros des comptes d'administration