Как назначить номера факса с использованием API Факса?

Общий обзор

В этом руководстве объясняется, как назначить номер факса корпоративным пользователям через Fax.Plus API. Вы узнаете, как составить список корпоративных участников, назначить номера определенным пользователям и, при необходимости, отозвать номера назначений.

Предпосылки

• Активная учетная запись Fax.Plus Enterprise
• Допустимые учетные данные API
• Два или более номера факсов на вашем счете

Пошаговое руководство

1. Список корпоративных членов
   Во-первых, вы получите список всех участников вашей корпоративной учетной записи. Доступ к этой конечной точке возможен только с помощью учетных записей администратора.
   GET /v3/accounts

{
"members": [
{
"account_data": {
"company_name": "Название компании",
"default_file_type": "pdf",
"save_history": истина
},
"account_type": "corporate_admin",
"email": "John@sample. om",
"фамилия": "Смит",
"статус": "активный", "активный",
"uid": "7724157c0974440293e45877c57f0703"
}
]
}Важно: Обратите внимание на UIDчлена для назначения номера. You'll need this in the next step.
   Learn more: List corporate members - Fax.Plus API
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. Revoke number assignment
   If you need to remove a number assignment from a user, use this endpoint:
   DELETE /v3/accounts/{user_id}/numbers/{number}
   Learn more: Revoke number - Fax.Plus API
   Parameters:
   
   • user_idID пользователя для снятия номера с
   • numberFax number to remove from the user

Устранение проблем

Общие вопросы и решения

1. 403 Запрещенная ошибка
   
   • Причина: Недостаточно прав доступа или учетной записи без администрирования
   • Решение: Проверьте, что вы используете учетную запись администратора и имеете необходимые области API
2. Ошибка 404 не найдена
   • Причина: Неверный ID пользователя или номер факса
   • Решение: Проверьте правильность номера пользователя и факса
3. 400 ошибочная ошибка запроса
   • Причина: Неверный формат запроса или попытка удалить число из администратора
   • Решение: Подтвердите формат запроса и убедитесь, что вы не пытаетесь удалить номера из учетной записи администратора