Benachrichtigungen
Funktionsunterstützung über app.capabilities prüfen, Autorisierung über app.access und Host-Berechtigungen. Die Beispiele verwenden synthetische Werte; vor dem Aufruf Pfade, IDs, Eingaben und Filter ersetzen.
Typdefinitionen
type Subscription {
notificationCreated: Notification!
notificationUpdated: Notification!
notificationDeleted: Notification!
notificationRefreshed: Boolean!
}
type Mutation {
deleteNotifications(ids: [ID!]!): ActionResult!
replyNotification(id: ID!, actionIndex: Int!, text: String!): Boolean!
}
type Query {
notificationCount(query: String!): Int!
notifications(query: String!, offset: Int!, limit: Int!): [Notification!]!
}
type ActionResult {
affectedCount: Int!
}
scalar Instant
type Notification {
id: ID!
onlyOnce: Boolean!
isClearable: Boolean!
appId: ID!
appName: String!
postedAt: Instant!
silent: Boolean!
title: String!
body: String!
actions: [String!]!
replyActions: [String!]!
}Operationen
notificationCreated
Empfängt eine neu beobachtete Gerätebenachrichtigung.
subscription notificationCreated {
notificationCreated { id onlyOnce isClearable appId appName postedAt silent title }
}notificationUpdated
Empfängt eine aktualisierte Gerätebenachrichtigung.
subscription notificationUpdated {
notificationUpdated { id onlyOnce isClearable appId appName postedAt silent title }
}notificationDeleted
Empfängt eine entfernte Gerätebenachrichtigung.
subscription notificationDeleted {
notificationDeleted { id onlyOnce isClearable appId appName postedAt silent title }
}notificationRefreshed
Empfängt ein Signal zum Aktualisieren der aktuellen Gerätebenachrichtigungsliste.
subscription notificationRefreshed {
notificationRefreshed
}deleteNotifications
Löscht die angegebenen Benachrichtigungsdatensätze und meldet deren Anzahl.
mutation deleteNotifications($ids: [ID!]!) {
deleteNotifications(ids: $ids) { affectedCount }
}replyNotification
Antwortet auf eine Benachrichtigung über eine Inline-Antwortaktion. actionIndex ist der bei 0 beginnende Index unter den antwortfähigen Aktionen.
# `actionIndex` indexes [`Notification::reply_actions`], the
# reply-capable subset — not the plain action list.
mutation replyNotification($id: ID!, $actionIndex: Int!, $text: String!) {
replyNotification(id: $id, actionIndex: $actionIndex, text: $text)
}notificationCount
Zählt gespeicherte Benachrichtigungen, die der Abfrage entsprechen.
query notificationCount($query: String!) {
notificationCount(query: $query)
}notifications
Liest eine Seite gespeicherter Gerätebenachrichtigungen, die der Abfrage entsprechen.
query notifications($query: String!, $offset: Int!, $limit: Int!) {
notifications(query: $query, offset: $offset, limit: $limit) { id onlyOnce isClearable appId appName postedAt silent title }
}