SMSEagle bietet leistungsstarke integrierte REST-API-Funktionalitäten. Die API ist für die Integration von SMSEagle mit jedem externen System oder jeder Anwendung vorgesehen.

API-Referenz (Dokumentation)

Das SMSEagle-Gerät bietet zwei API-Versionen: APIv2 und APIv1.

• API v2 – empfohlen für neue Projekte Moderne RESTful API basierend auf der OpenAPI 3.0-Spezifikation Link zur APIv2-Referenz

• API v1 – für bestehende Projekte und Abwärtskompatibilität Einfache HTTP- und JSONRPC-API Link zur APIv1-Referenz

Aufgrund des umfangreichen Inhalts der API-Dokumentation wurde diese in ein separates Dokument verschoben. Folgen Sie den obigen Links, um die jeweilige Spezifikation jeder API zu finden.

API-Zugriff

Bevor Sie die SMSEagle API verwenden können, müssen Sie den API-Zugriff im Web-GUI aktivieren (Menü Users). Nachfolgend finden Sie die Beschreibung, wie Sie die API auf Ihrem Gerät aktivieren.

Screenshot des Menüs „Users“ mit markiertem Link „Access to API“.

Der Zugriff kann gewährt werden für:

• APIv1

• APIv2

• Der API-Zugriffstoken kann generiert oder eingegeben werden

• Für APIv1 kann eine Benutzername/Passwort-Authentifizierung gewährt werden (dies nur zur Abwärtskompatibilität verwenden)

• Für APIv2 kann der Zugriff auf Ressourcen anderer Benutzer (von anderen erstellt) gewährt werden

• Bestimmte Berechtigungen können für Methoden in APIv1 & APIv2 gewährt werden

Zugriff auf Ressourcen anderer Benutzer in der API

In APIv1 hat ein API-Benutzer (einzelner API-Schlüssel) standardmäßig Zugriff auf Ressourcen aller anderen Benutzer (Telefonbuchkontakte, Gruppen usw.). APIv2 ist beim Ressourcenzugriff granularer: Ein API-Benutzer (einzelner API-Schlüssel) hat standardmäßig nur Zugriff auf Ressourcen, die er selbst erstellt hat. Wenn Sie den Zugriff auf Ressourcen aller anderen Benutzer erlauben möchten, müssen Sie das Kontrollkästchen „Access to resources of all users“ im Fenster Access to API aktivieren.