Zum Hauptinhalt springen

Get dashboard notifications and pending actions

GET 
/company/notifications/dashboard

Ruft konsolidierte Informationen für das Dashboard der Unternehmensbenachrichtigungen ab, einschließlich ungelesener Benachrichtigungen und Warnungen zu ausstehenden Aktionen wie nicht unterschriebenen Auktionen.

Ziel​

Ermöglicht Unternehmen, alle kritischen Warnungen und ausstehenden Benachrichtigungen in einem einzigen Endpunkt einzusehen und optimiert so die Benutzererfahrung im Haupt-Dashboard.

Anwendungsfälle​

  • Haupt-Dashboard: Erstes Laden des Unternehmens-Dashboards
  • Echtzeit-Aktualisierung: Regelmäßige Aktualisierung von Benachrichtigungen
  • Unterschriftswarnungen: Erinnerung an Auktionen, die noch von der Firma unterschrieben werden müssen
  • Aktivitätsmonitor: Verfolgung ungelesener Benachrichtigungen

Datenfluss​

Der Endpunkt implementiert ein Priorisierungssystem mit begrenzten Slots (maximal 6 Einträge):

flowchart TD
    A[Request Dashboard] --> B{User Authenticated?}
    B -->|No| C[404 USER_NOT_FOUND]
    B -->|Yes| D{Company Exists?}
    D -->|No| E[401 CIA_NOT_FOUND]
    D -->|Yes| F[Get Company Data]
    F --> G{Missing Signature?}
    G -->|Yes| H[companyMissingSignature: true]
    G -->|No| I[companyMissingSignature: false]
    H --> J[Find Auctions Without Signature]
    I --> J
    J --> K{Count > 6?}
    K -->|Yes| L[Limit: 6 Auctions]
    K -->|No| M[Use All Auctions]
    L --> N[Calculate Available Slots]
    M --> N
    N --> O{Slots > 0?}
    O -->|No| P[Return Dashboard]
    O -->|Yes| Q[Get Unread Notifications]
    Q --> R[Fill Available Slots]
    R --> S[Return Dashboard - 200]

Antwortfelder​

companyMissingSignature (boolean):

  • true: Das Unternehmen hat seinen Unterschriftsprozess nicht abgeschlossen

Request​

Responses​

Dashboard für Benachrichtigungen erfolgreich abgerufen.

Das Antwortobjekt enthält bis zu 6 Elemente, verteilt auf:

  • Auktionen, die zur Unterschrift ausstehen (höchste Priorität)
  • Ungelesene Benachrichtigungen (füllen die verbleibenden Plätze)