@magicbell/user-client

Client TypeScript SDK 0.2.0

Welcome to the Client SDK documentation. This guide will help you get started with integrating and using the Client SDK in your project.

Versions

• API version: 2.0.0
• SDK version: 0.2.0

About the API

OpenAPI 3.1.0 Specification for MagicBell API.

Table of Contents

• Setup & Configuration
  • Supported Language Versions
  • Installation
• Authentication
  • Access Token Authentication
• Setting a Custom Timeout
• Sample Usage
• Services
• Models

Setup & Configuration

Supported Language Versions

This SDK is compatible with the following versions: TypeScript >= 4.8.4

Installation

To get started with the SDK, we recommend installing using npm:

npm install @magicbell/user-client

Authentication

Access Token Authentication

The Client API uses an Access Token for authentication.

This token must be provided to authenticate your requests to the API.

Setting the Access Token

When you initialize the SDK, you can set the access token as follows:

const sdk = new Client({ token: 'YOUR_TOKEN' });

If you need to set or update the access token after initializing the SDK, you can use:

const sdk = new Client();
sdk.token = 'YOUR_TOKEN';

Setting a Custom Timeout

You can set a custom timeout for the SDK's HTTP requests as follows:

const client = new Client({ timeout: 10000 });

Sample Usage

Below is a comprehensive example demonstrating how to authenticate and call a simple endpoint:

import { Client } from '@magicbell/user-client';

(async () => {
  const client = new Client({
    token: 'YOUR_TOKEN',
  });

  const { data } = await client.channels.getMobilePushApnsTokens({
    pageSize: 9,
    pageAfter: 'page[after]',
    pageBefore: 'page[before]',
  });

  console.log(data);
})();

Services

The SDK provides various services to interact with the API.

Below is a list of all available services with links to their detailed documentation:

Name
ChannelsService
IntegrationsService

Models

The SDK includes several models that represent the data structures used in API requests and responses. These models help in organizing and managing the data efficiently.

Below is a list of all available models with links to their detailed documentation:

Name	Description
ArrayOfMetadataApnsTokens
ApnsToken
MetadataApnsToken
DiscardResult
ArrayOfMetadataExpoTokens
ExpoToken
MetadataExpoToken
ArrayOfMetadataFcmTokens
FcmToken
MetadataFcmToken
ArrayOfMetadataSlackTokens
SlackToken
MetadataSlackToken
ArrayOfMetadataTeamsTokens
TeamsToken
MetadataTeamsToken
ArrayOfMetadataWebPushTokens
WebPushToken
MetadataWebPushToken
InboxConfig
SlackInstallation
SlackFinishInstallResponse
SlackStartInstall
SlackStartInstallResponseContent
TemplatesInstallation
WebPushStartInstallationResponse
Links
TokenMetadata