Wie weisen Sie Faxnummern mit der Fax.Plus-API zu?

Überblick

Dieser Leitfaden erklärt, wie Sie Faxnummern über die Fax.Plus-API Unternehmensbenutzern zuweisen. Sie erfahren, wie Sie Unternehmensmitglieder auflisten, Nummern bestimmten Benutzern zuweisen und Nummernzuweisungen bei Bedarf aufheben.

Voraussetzungen

• Ein aktives Fax.Plus-Enterprise-Konto
• Gültige API-Anmeldedaten
• Zwei oder mehr Faxnummern in Ihrem Konto

Schritt-für-Schritt-Anleitung

1. Liste der Unternehmensmitglieder abrufen
   Rufen Sie zunächst eine Liste aller Mitglieder in Ihrem Unternehmenskonto ab. Auf diesen Endpunkt kann nur von Admin-Konten zugegriffen werden.
   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"
}
]
}Wichtig: Notieren Sie sich die UIDdes Mitglieds, dem Sie die Nummer zuweisen möchten. Sie benötigen diese im nächsten Schritt.
   Weitere Informationen: Unternehmensmitglieder auflisten – Fax.Plus API
2. Nummer dem Benutzer zuweisen
   Sobald Sie die UIDdes Benutzers haben, können Sie ihm über den folgenden Endpunkt eine Faxnummer zuweisen:
   POST /v3/accounts/self/numbers/{number}
   Request-Body:
   {
"assigned_to": "<uid>"
}Ersetzen Sie {number} in der URL durch die tatsächliche Faxnummer, die Sie zuweisen möchten, und den Wert assigned_todurch die UIDdes Benutzers.
   Weitere Informationen: Nummer zuweisen – Fax.Plus API
3. Nummernzuweisung aufheben
   Wenn Sie eine Nummernzuweisung von einem Benutzer entfernen müssen, verwenden Sie diesen Endpunkt:
   DELETE /v3/accounts/{user_id}/numbers/{number}
   Weitere Informationen: Nummer widerrufen – Fax.Plus API
   Parameter:
   
   • user_idID des Benutzers, dem die Nummer entzogen werden soll
   • numberFaxnummer, die vom Benutzer entfernt werden soll

Fehlerbehebung

Häufige Probleme und Lösungen

1. 403-Fehler „Forbidden“
   
   • Ursache: Unzureichende Berechtigungen oder kein Admin-Konto
   • Lösung: Stellen Sie sicher, dass Sie ein Admin-Konto verwenden und die erforderlichen API-Berechtigungen besitzen
2. 404-Fehler „Not Found“
   • Ursache: Ungültige Benutzer-ID oder Faxnummer
   • Lösung: Überprüfen Sie, ob die Benutzer-ID und die Faxnummer korrekt sind
3. 400-Fehler „Bad Request“
   • Ursache: Ungültiges Anfrageformat oder Versuch, eine Nummer von einem Administrator zu entfernen
   • Lösung: Überprüfen Sie das Anfrageformat und stellen Sie sicher, dass Sie nicht versuchen, Nummern von Admin-Konten zu entfernen