Przegląd
Ten przewodnik wyjaśnia, jak przypisywać numery fax użytkownikom firmowym za pomocą API Fax.Plus. Dowiesz się, jak wyświetlić listę członków firmy, przypisać numery konkretnym użytkownikom oraz w razie potrzeby cofnąć przypisanie numerów.
Wymagania wstępne
- Aktywne konto Fax.Plus Enterprise
- Ważne dane uwierzytelniające API
- Co najmniej dwa numery fax na Twoim koncie
Przewodnik krok po kroku
-
Wyświetl listę członków firmy
Najpierw pobierz listę wszystkich użytkowników na koncie firmowym. Ten punkt końcowy jest dostępny tylko dla kont administratora.GET /v3/accounts{Ważne: Zapisz
"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"
}
]
}UIDużytkownika, do którego chcesz przypisać numer. Będzie to potrzebne w następnym kroku.
Więcej informacji: Lista członków firmy - Fax.Plus API -
Przypisz numer do użytkownika
Gdy maszUIUużytkownika, możesz przypisać mu numer fax za pomocą następującego punktu końcowego:POST /v3/accounts/self/numbers/{number}
Treść żądania:{Zastąp
"assigned_to": "<uid>"
}{number}w adresie URL rzeczywistym numerem fax, który chcesz przypisać, a wartośćassigned_tozamień naUIUużytkownika.
Więcej informacji: Przypisywanie numeru - Fax.Plus API - Usuń przypisanie numeru
Jeśli chcesz usunąć przypisanie numeru użytkownikowi, użyj tego punktu końcowego:DELETE /v3/accounts/{user_id}/numbers/{number}
Więcej informacji: Usuwanie przypisania numeru - Fax.Plus API
Parametry:
-
user_ididentyfikator użytkownika, któremu ma zostać usunięte przypisanie numeru -
numbernumer fax, który ma zostać usunięty użytkownikowi
-
Rozwiązywanie problemów
Najczęstsze problemy i rozwiązania
-
Błąd 403 Forbidden
- Przyczyna: Niewystarczające uprawnienia lub konto niebędące kontem administratora
- Rozwiązanie: Sprawdź, czy używasz konta administratora i masz wymagane zakresy API
-
Błąd 404 Not Found
- Przyczyna: Nieprawidłowy identyfikator użytkownika lub numer fax
- Rozwiązanie: Sprawdź dwukrotnie, czy identyfikator użytkownika i numer fax są prawidłowe
-
Błąd 400 Bad Request
- Przyczyna: Nieprawidłowy format żądania lub próba usunięcia numeru z konta administratora
- Rozwiązanie: Sprawdź format żądania i upewnij się, że nie próbujesz usuwać numerów z kont administratorów