API-Integration für externe Systeme

Der externe API-Zugriff ermöglicht es Drittanbietern, über authentifizierte API-Anfragen eine Verbindung zu den internen Ressourcen einer Organisation herzustellen.

Führen Sie die folgenden Schritte aus, um den API-Zugriff* für externe Integrationen zu konfigurieren:

– Navigieren Sie in der Appterix-Management UI zu Einstellungen > Allgemeine Einstellungen.

– Scrollen Sie nach unten zum Abschnitt Externer API-Zugriff.

– Aktivieren Sie die Option Externer API-Zugriff.

– Klicken Sie auf Neue Anmeldeinformationen generieren, um ein Client-Secret und eine Client-ID zu erstellen.

– Kopieren Sie die Werte für Server-URL, Client-ID und Client-Secret.

*Fordern Sie beim Support support@egomind.eu die Dokumentation zu allen verfügbaren API-Methoden an.

Beispiel: Geräteinformationen abrufen

Die folgende Anfrage gibt eine Liste aller verfügbaren YubiKey-Geräte zurück.

GET https://sample.appterix.eu/api/external/ybk-management/devices

Authorization: Bearer <access_token>

Beispielantwort (Auszug)

[
    {
        "yubikey": {
            "code": 12345,
            "orgCode": 123,
            "name": "YubiKey 5 NFC",
            "description": null,
            "uniqueId": "123456",
            "serialNumber": "12345678",
            "alternativeSerialNumber": null,
            "firmwareVersion": "5.7.2",
            "model": {
                "code": 20,
                "name": "YubiKey 5 NFC",
                "uniqueId": "00yk12345678",
                "prodLineCode": 100,
                "formFactor": 1,
                "interfaces": [
                    3
                ],
                "usbCapabilities": [
                    1
                ],
                "nfcCapabilities": [
                    1
                ]
            },
            "enabledUSBCapabilities": [
                1
            ],
            "enabledNFCCapabilities": [
                1
            ],
            "lastUpdate": "2026-05-05T14:11:42.78Z",
            "lastUsed": "2026-05-05T14:09:08.6Z",
            "status": 1
        },
        "owners": {
            "count": 1,
            "items": [
                {
                    "code": 12345,
                    "name": "sample-user",
                    "email": "mail@sample.com",
                    "isAdmin": false,
                    "sid": "S-1-5-21-123456789-123456789-123456798-123",
                    "entraId": "",
                    "lastLogin": "2026-05-05T14:05:34.787+00:00",
                    "profilePicture": "",
                    "profilePictureSmall": "",
                    "profilePictureMedium": "",
                    "isExternal": false,
                    "groups": {
                        "count": 2,
                        "items": [
                            {
                                "type": 3,
                                "source": 1,
                                "description": "",
                                "code": -1,
                                "name": "Directory users (Default)"
                            },
                            {
                                "type": 3,
                                "source": 1,
                                "description": "",
                                "code": 12345,
                                "name": ""
                            }
                        ]
                    },
                    "tags": {
                        "count": 1,
                        "items": [
                            {
                                "type": 1,
                                "source": 1,
                                "description": "",
                                "code": 1234,
                                "name": ""
                            }
                        ]
                    }
                }
            ]
        },
        "tags": [],
        "status": {
            "code": 12345,
            "name": "Shared"
        }
    }   
]