API für die Hosted PBX: Kundenmandanten

Verwenden Sie HTTPS und HTTP-Basic-Authentifizierung mit genehmigten API-Zugangsdaten. Bewahren Sie die Zugangsdaten auf Ihrem Anwendungsserver auf. Diese Hosted-PBX-Endpunkte verwenden /hpbx/ auf api.multitel.net; fügen Sie nicht /v3 ein. Prüfen Sie sowohl das HTTP-Ergebnis als auch den Anwendungsstatus in der JSON-Antwort.

PBX-Mandanten des Kontos auflisten

curl --request POST --user "USERNAME:PASSWORD" \
  "https://api.multitel.net/hpbx/tenants/list/0"

Der Listenvorgang gibt die Mandanten des authentifizierten Kontos zurück. Das abschließende Platzhaltersegment erfüllt die Routensignatur; der Listenvorgang verwendet es nicht, um ein anderes Konto auszuwählen.

Beispielhafte Listenantwort

{
  "status": {
    "code": "200",
    "msg": "List data"
  },
  "response": [
    {
      "billing_code": "EXAMPLE_BILLING_CODE",
      "isocode": "US",
      "continent_iso": "NA",
      "continent_name": "North America"
    }
  ]
}

Einen PBX-Mandanten erstellen und ändern

Das Anlegen einer getrennten PBX-Kundeninstanz (eines Mandanten) ist eine Abonnementaktion und kann Einrichtungs- und wiederkehrende Gebühren verursachen. Lesen Sie zuerst die verfügbaren Dienstpläne. Verwenden Sie die aktuelle, für Ihr Konto autorisierte Referenz, um einen Plan, einen Standort und ein Routing-Profil auszuwählen; übernehmen Sie keine Beispiel-ID als Auswahl für Ihr Konto.

ErstellungsfeldBedeutung
hosted_pbx_services_idDie für einen verfügbaren Tarif zurückgegebene Service-ID.
te_rp_idDas genehmigte Anruf-Routing-Profil.
timezoneEine IANA-Zeitzone wie America/Detroit.
te_location_idEine für das Konto verfügbare Standort-ID, falls erforderlich.
te_maxextensions / te_maxhunts / te_maxconferences / te_maxvoicemails / te_maxivrsDie Ressourcenkapazitäten sind durch den gewählten Dienst begrenzt; die gebuchten Leistungsgrenzen lassen sich damit nicht beliebig überschreiben.

Prüfen Sie den resultierenden Abrechnungscode und den Bereitstellungsstatus, bevor Sie Nebenstellen konfigurieren. Für neue Integrationen und genaue Mutationsschemata verwenden Sie die aktuelle Abonnement-Referenz.

Dokumentation suchen