Übersicht
Dieser Leitfaden erklärt, wie man Firmenbenutzern Faxnummern über die Fax.Plus API zuweisen kann. Sie lernen, wie Sie Firmenmitglieder auflisten, bestimmten Benutzern Zahlen zuweisen und bei Bedarf Nummernzuweisungen widerrufen können.
Voraussetzungen
- Ein aktives Fax.Plus Enterprise Konto
- Gültige API-Zugangsdaten
- Zwei oder mehr Faxnummern in Ihrem Konto
Schritt-für-Schritt Anleitung
-
Unternehmensmitglieder
zuerst auflisten, eine Liste aller Mitglieder in Ihrem Firmenkonto abrufen. Auf diesen Endpunkt kann nur von Admin-Konten zugegriffen werden.GET /v3/Konten
{
Wichtig: Hinweis auf die
"members": [
{
"account_data": {
"company_name": "Firmenname",
"default_file_type": "pdf",
"save_history": true
},
"account_type": "corporate_admin",
"email": "John@sample. om",
"lastname": "Smith",
"status": "aktiv",
"uid": "7724157c0974440293e45877c57f0703"
}
]
}UID
des Mitglieds, dem Sie die Nummer zuweisen möchten. Sie benötigen dies im nächsten Schritt.
Mehr erfahren: Unternehmensmitglieder auflisten - Fax.Plus API -
Assign a number to the user
Once you have the user'sUIU
, you can assign a fax number to them using the following endpoint:POST /v3/accounts/self/numbers/{number}
Request body:{
Replace
"assigned_to": "<uid>"
}{number}
in the URL with the actual fax number you want to assign, and theassigned_to
value with the user'sUIU
.
Learn more: Assign number - Fax.Plus API - 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_id
ID des Benutzers, um die Nummer zu widerrufen von -
Nummer
Faxnummer, die vom Benutzer entfernt werden soll
-
Fehlerbehebung
Häufige Probleme und Lösungen
-
403 Verbotener Fehler
- Grund: Unzureichende Berechtigungen oder kein Admin-Konto
- Lösung: Vergewissern Sie sich, dass Sie ein Administratorkonto verwenden und die benötigten API-Bereiche haben
-
404 Nicht gefunden Fehler
- Grund: Ungültige Benutzer-ID oder Faxnummer
- Lösung: Überprüfen Sie die Benutzer-ID und die Faxnummer sind korrekt
-
400 Fehler bei der Anfrage
- Grund: Ungültiges Anfrageformat oder Versuch, eine Zahl vom Admin zu entfernen
- Lösung: Verifiziere das Anfrageformat und stelle sicher, dass du nicht versuchst, Nummern von Admin-Konten zu entfernen