Skip to content

NotificationsService.md

Latest commit

 

History

History
352 lines (229 loc) · 12 KB

NotificationsService.md

File metadata and controls

352 lines (229 loc) · 12 KB

NotificationsService

A list of all methods in the NotificationsService service. Click on the method name to view detailed information about that method.

Methods Description
listNotifications Lists all notifications for a user.
archiveAllNotifications Archive all notifications.
markAllNotificationsRead Marks all notifications as read.
fetchUnreadNotificationsCount Returns the count of unread notifications for a user. Supports filtering by category and topic.
fetchNotification Gets a notification by ID.
archiveNotification Archive a notification.
markNotificationRead Marks a notification as read.
unarchiveNotification Unarchives a notification.
markNotificationUnread Marks a notification as unread.

listNotifications

Lists all notifications for a user.

  • HTTP Method: GET
  • Endpoint: /notifications

Parameters

Name Type Required Description
requestParameters ListNotificationsParameters ❌ Request Parameters Object

Return Type

NotificationCollection

Example Usage Code Snippet

import com.magicbell.magicbelluserclient.MagicbellUserClient;
import com.magicbell.magicbelluserclient.config.MagicbellUserClientConfig;
import com.magicbell.magicbelluserclient.models.ListNotificationsParameters;
import com.magicbell.magicbelluserclient.models.NotificationCollection;

public class Main {

  public static void main(String[] args) {
    MagicbellUserClientConfig config = MagicbellUserClientConfig.builder().accessToken("YOUR_ACCESS_TOKEN").build();

    MagicbellUserClient magicbellUserClient = new MagicbellUserClient(config);

    ListNotificationsParameters requestParameters = ListNotificationsParameters.builder()
      .limit(5L)
      .startingAfter("starting_after")
      .endingBefore("ending_before")
      .status("status")
      .category("category")
      .topic("topic")
      .build();

    NotificationCollection response = magicbellUserClient.notifications.listNotifications(requestParameters);

    System.out.println(response);
  }
}

archiveAllNotifications

Archive all notifications.

  • HTTP Method: POST
  • Endpoint: /notifications/archive

Parameters

Name Type Required Description
requestParameters ArchiveAllNotificationsParameters ❌ Request Parameters Object

Example Usage Code Snippet

import com.magicbell.magicbelluserclient.MagicbellUserClient;
import com.magicbell.magicbelluserclient.config.MagicbellUserClientConfig;
import com.magicbell.magicbelluserclient.models.ArchiveAllNotificationsParameters;

public class Main {

  public static void main(String[] args) {
    MagicbellUserClientConfig config = MagicbellUserClientConfig.builder().accessToken("YOUR_ACCESS_TOKEN").build();

    MagicbellUserClient magicbellUserClient = new MagicbellUserClient(config);

    ArchiveAllNotificationsParameters requestParameters = ArchiveAllNotificationsParameters.builder()
      .category("category")
      .topic("topic")
      .build();

    magicbellUserClient.notifications.archiveAllNotifications(requestParameters);
  }
}

markAllNotificationsRead

Marks all notifications as read.

  • HTTP Method: POST
  • Endpoint: /notifications/read

Parameters

Name Type Required Description
requestParameters MarkAllNotificationsReadParameters ❌ Request Parameters Object

Example Usage Code Snippet

import com.magicbell.magicbelluserclient.MagicbellUserClient;
import com.magicbell.magicbelluserclient.config.MagicbellUserClientConfig;
import com.magicbell.magicbelluserclient.models.MarkAllNotificationsReadParameters;

public class Main {

  public static void main(String[] args) {
    MagicbellUserClientConfig config = MagicbellUserClientConfig.builder().accessToken("YOUR_ACCESS_TOKEN").build();

    MagicbellUserClient magicbellUserClient = new MagicbellUserClient(config);

    MarkAllNotificationsReadParameters requestParameters = MarkAllNotificationsReadParameters.builder()
      .category("category")
      .topic("topic")
      .build();

    magicbellUserClient.notifications.markAllNotificationsRead(requestParameters);
  }
}

fetchUnreadNotificationsCount

Returns the count of unread notifications for a user. Supports filtering by category and topic.

  • HTTP Method: GET
  • Endpoint: /notifications/unread/count

Parameters

Name Type Required Description
requestParameters FetchUnreadNotificationsCountParameters ❌ Request Parameters Object

Return Type

CountResponse

Example Usage Code Snippet

import com.magicbell.magicbelluserclient.MagicbellUserClient;
import com.magicbell.magicbelluserclient.config.MagicbellUserClientConfig;
import com.magicbell.magicbelluserclient.models.CountResponse;
import com.magicbell.magicbelluserclient.models.FetchUnreadNotificationsCountParameters;

public class Main {

  public static void main(String[] args) {
    MagicbellUserClientConfig config = MagicbellUserClientConfig.builder().accessToken("YOUR_ACCESS_TOKEN").build();

    MagicbellUserClient magicbellUserClient = new MagicbellUserClient(config);

    FetchUnreadNotificationsCountParameters requestParameters = FetchUnreadNotificationsCountParameters.builder()
      .category("category")
      .topic("topic")
      .build();

    CountResponse response = magicbellUserClient.notifications.fetchUnreadNotificationsCount(requestParameters);

    System.out.println(response);
  }
}

fetchNotification

Gets a notification by ID.

  • HTTP Method: GET
  • Endpoint: /notifications/{notification_id}

Parameters

Name Type Required Description
notificationId String ✅

Return Type

Notification

Example Usage Code Snippet

import com.magicbell.magicbelluserclient.MagicbellUserClient;
import com.magicbell.magicbelluserclient.config.MagicbellUserClientConfig;
import com.magicbell.magicbelluserclient.models.Notification;

public class Main {

  public static void main(String[] args) {
    MagicbellUserClientConfig config = MagicbellUserClientConfig.builder().accessToken("YOUR_ACCESS_TOKEN").build();

    MagicbellUserClient magicbellUserClient = new MagicbellUserClient(config);

    Notification response = magicbellUserClient.notifications.fetchNotification("notification_id");

    System.out.println(response);
  }
}

archiveNotification

Archive a notification.

  • HTTP Method: POST
  • Endpoint: /notifications/{notification_id}/archive

Parameters

Name Type Required Description
notificationId String ✅

Example Usage Code Snippet

import com.magicbell.magicbelluserclient.MagicbellUserClient;
import com.magicbell.magicbelluserclient.config.MagicbellUserClientConfig;

public class Main {

  public static void main(String[] args) {
    MagicbellUserClientConfig config = MagicbellUserClientConfig.builder().accessToken("YOUR_ACCESS_TOKEN").build();

    MagicbellUserClient magicbellUserClient = new MagicbellUserClient(config);

    magicbellUserClient.notifications.archiveNotification("notification_id");
  }
}

markNotificationRead

Marks a notification as read.

  • HTTP Method: POST
  • Endpoint: /notifications/{notification_id}/read

Parameters

Name Type Required Description
notificationId String ✅

Example Usage Code Snippet

import com.magicbell.magicbelluserclient.MagicbellUserClient;
import com.magicbell.magicbelluserclient.config.MagicbellUserClientConfig;

public class Main {

  public static void main(String[] args) {
    MagicbellUserClientConfig config = MagicbellUserClientConfig.builder().accessToken("YOUR_ACCESS_TOKEN").build();

    MagicbellUserClient magicbellUserClient = new MagicbellUserClient(config);

    magicbellUserClient.notifications.markNotificationRead("notification_id");
  }
}

unarchiveNotification

Unarchives a notification.

  • HTTP Method: POST
  • Endpoint: /notifications/{notification_id}/unarchive

Parameters

Name Type Required Description
notificationId String ✅

Example Usage Code Snippet

import com.magicbell.magicbelluserclient.MagicbellUserClient;
import com.magicbell.magicbelluserclient.config.MagicbellUserClientConfig;

public class Main {

  public static void main(String[] args) {
    MagicbellUserClientConfig config = MagicbellUserClientConfig.builder().accessToken("YOUR_ACCESS_TOKEN").build();

    MagicbellUserClient magicbellUserClient = new MagicbellUserClient(config);

    magicbellUserClient.notifications.unarchiveNotification("notification_id");
  }
}

markNotificationUnread

Marks a notification as unread.

  • HTTP Method: POST
  • Endpoint: /notifications/{notification_id}/unread

Parameters

Name Type Required Description
notificationId String ✅

Example Usage Code Snippet

import com.magicbell.magicbelluserclient.MagicbellUserClient;
import com.magicbell.magicbelluserclient.config.MagicbellUserClientConfig;

public class Main {

  public static void main(String[] args) {
    MagicbellUserClientConfig config = MagicbellUserClientConfig.builder().accessToken("YOUR_ACCESS_TOKEN").build();

    MagicbellUserClient magicbellUserClient = new MagicbellUserClient(config);

    magicbellUserClient.notifications.markNotificationUnread("notification_id");
  }
}