Overzicht
Deze handleiding legt uit hoe u faxnummers toewijst aan zakelijke gebruikers via de Fax.Plus API. U leert hoe u zakelijke leden weergeeft, nummers toewijst aan specifieke gebruikers en nummertoewijzingen intrekt wanneer dat nodig is.
Vereisten
- Een actief Fax.Plus Enterprise-account
- Geldige API-inloggegevens
- Twee of meer faxnummers in uw account
Stapsgewijze handleiding
-
Zakelijke leden weergeven
Haal eerst een lijst op van alle leden in uw zakelijke account. Dit endpoint is alleen toegankelijk voor beheerdersaccounts.GET /v3/accounts{Belangrijk: Noteer de
"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"
}
]
}UIDvan het lid aan wie u het nummer wilt toewijzen. U hebt deze nodig in de volgende stap.
Meer informatie: Zakelijke leden weergeven - Fax.Plus API -
Een nummer aan de gebruiker toewijzen
Zodra u deUIUvan de gebruiker hebt, kunt u een faxnummer aan deze gebruiker toewijzen met het volgende endpoint:POST /v3/accounts/self/numbers/{number}
Hoofdtekst van de aanvraag:{Vervang
"assigned_to": "<uid>"
}{number}in de URL door het daadwerkelijke faxnummer dat u wilt toewijzen, en de waardeassigned_todoor deUIUvan de gebruiker.
Meer informatie: Nummer toewijzen - Fax.Plus API - Nummertoewijzing intrekken
Als u een nummertoewijzing bij een gebruiker wilt verwijderen, gebruikt u dit endpoint:DELETE /v3/accounts/{user_id}/numbers/{number}
Meer informatie: Nummer intrekken - Fax.Plus API
Parameters:
-
user_idID van de gebruiker bij wie het nummer moet worden ingetrokken -
numberFaxnummer dat bij de gebruiker moet worden verwijderd
-
Probleemoplossing
Veelvoorkomende problemen en oplossingen
-
403 Forbidden-fout
- Oorzaak: Onvoldoende rechten of een account zonder beheerdersrechten
- Oplossing: Controleer of u een beheerdersaccount gebruikt en over de vereiste API-scopes beschikt
-
404 Not Found-fout
- Oorzaak: Ongeldige gebruikers-ID of ongeldig faxnummer
- Oplossing: Controleer nogmaals of de gebruikers-ID en het faxnummer correct zijn
-
400 Bad Request-fout
- Oorzaak: Ongeldig aanvraagformaat of een poging om een nummer bij een beheerder te verwijderen
- Oplossing: Controleer het aanvraagformaat en zorg ervoor dat u niet probeert nummers bij beheerdersaccounts te verwijderen