API Reference

Dieser Abschnitt bietet die vollständige API-Referenz für Hydden.Control. Alle Endpoints verwenden JSON für Request- und Response-Bodies und erfordern Authentifizierung, sofern nicht anders angegeben.

Basis-URL

https://{your-tenant}.hydden.io/api/v1

Authentifizierung

Alle API-Anfragen erfordern ein gültiges Bearer-Token im Authorization-Header:

Authorization: Bearer {access_token}

Verfügbare Endpoints

Identitätsdaten

Ressource	Beschreibung
Accounts	Benutzerkonten, Attribute und Risikoberechnungen verwalten
Applications	Anwendungen und ihre zugehörigen Konten verwalten
Groups	Sicherheits- und Verteilergruppen verwalten
Owners	Identitätseigentümer und Organisationsbeziehungen verwalten

Access Governance

Ressource	Beschreibung
Campaigns	Zugriffsprüfungs-Campaigns erstellen und verwalten
Campaign Rules	Automatisierte Entscheidungsregeln für Campaigns definieren
Policies	Zugriffsrichtlinien erstellen und verwalten
Roles	Erkannte Rollen und Role Mining verwalten

Operationen

Ressource	Beschreibung
Jobs	Hintergrundaufgaben und Operationen überwachen
Sync	Datensynchronisierung auslösen und überwachen

Konfiguration

Ressource	Beschreibung
Settings	Integrations- und AI-Einstellungen verwalten
AI Assistant	Mit dem KI-gestützten Assistenten interagieren

Paginierung

Die meisten List-Endpoints unterstützen Cursor-basierte Paginierung:

GET /api/v1/accounts?limit=50&after=cursor-token

Parameter	Typ	Beschreibung
limit	number	Anzahl der Elemente pro Seite (Standard: 50)
after	string	Cursor für die nächste Seite

Antworten enthalten Paginierungsinformationen:

{
  "data": [...],
  "pageInfo": {
    "hasNextPage": true,
    "endCursor": "next-cursor-token"
  }
}

Fehlerbehandlung

Alle Endpoints geben Standard-HTTP-Statuscodes zurück:

Statuscode	Beschreibung
200	Success
201	Created
204	No Content
400	Bad Request - Ungültige Parameter
401	Unauthorized - Authentifizierung erforderlich
403	Forbidden - Unzureichende Berechtigungen
404	Not Found
409	Conflict - Ressourcenkonflikt
429	Too Many Requests - Ratenbegrenzt
500	Internal Server Error

Fehlerantworten enthalten Details:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Description of the error"
  }
}

Ratenbegrenzung

API-Anfragen sind ratenbegrenzt, um faire Nutzung zu gewährleisten. Wenn Sie das Limit überschreiten, erhalten Sie einen 429-Statuscode. Warten Sie vor dem erneuten Versuch.

Verwandte Themen

• Integration Settings - API-Zugriff konfigurieren
• Platform Users - Benutzerrollen und Berechtigungen