Integración de API para sistemas externos

El acceso a la API externa permite a los proveedores externos conectarse a los recursos internos de una organización mediante solicitudes de API autenticadas.

Siga estos pasos para configurar el acceso a la API* para integraciones externas:

– En la interfaz de usuario de administración de Appterix, navegue hasta Configuración > Configuración general.

– Desplácese hacia abajo hasta la sección Acceso a API externa.

– Activar la opción Acceso a API externa.

– Haga clic en Generar nueva información de inicio de sesiónconseguir un Secreto del cliente y Identificación del cliente crear.

– Copie los valores para URL del servidor, Identificación del cliente y la Secreto del cliente.

*Solicitud de soporte soporte@egomind.eu La documentación de todos los métodos API disponibles está disponible.

Ejemplo: Recuperación de información del dispositivo

La siguiente consulta devuelve una lista de todos los dispositivos YubiKey disponibles.

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

Autorización: Portador

Ejemplo de respuesta (fragmento)

[
    {
        "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"
        }
    }   
]