1.0.2-preps.0 • Published 1 year ago

@jfkz/sendbird-platform-sdk-typescript v1.0.2-preps.0

Weekly downloads
-
License
Unlicense
Repository
github
Last release
1 year ago

Sendbird Typescript Platform SDK

Disclamer: this is unofficial version of official SDK which is not updated for more than 2 years by now.

link to docs This is a Node.js package written in Typescript that makes talking to the Sendbird Platform API easier. With this library you can extend your Sendbird integration to include advanced features like message-, and channel automation, user management, create user authentication tokens, and create bots.

šŸ”„ Quick start

import * as sendbird from 'sendbird-platform-sdk-typescript';
const APP_ID = "YOUR_APP_ID_FROM_DASHBOARD";
const API_TOKEN = "YOUR_MASTER_API_TOKEN_FROM_DASHBOARD";
const serverConfig = new sendbird.ServerConfiguration("https://api-{app_id}.sendbird.com", { "app_id": APP_ID })
const configuration = sendbird.createConfiguration({ baseServer : serverConfig });
const userAPI = new sendbird.UserApi(configuration);
// List users, use the next token in the response to get the next page of users in subsequent requests
userAPI.listUsers(API_TOKEN, '', 10).then((users) => {
    console.log("Listing first 10 users:\n")
    console.log(users)
}).catch((error) => {
    console.log("Error listing users")
    console.log(error)
})
// How to create a user
const userData: sendbird.CreateUserData = {
    userId: "bob_smith",
    nickname: "Bob",
    profileUrl: "https://cataas.com/c"
}
userAPI.createUser(API_TOKEN, userData).then((user) => {
    console.log("User created:\n")
    console.log(user)
}).catch((error) => {
    console.log("Error creating user:")
    console.log(error)
})

āš ļø Warnings

  1. This package is not official! I made deployments and support by my own so beware of any errors or issues that may arise.
  2. This library is intended for server to server requests. Do not use in a browser environment. This SDK uses the Master API Token, which should never be exposed to the outside world like in a webpage or app.

āš’ļø Prerequisite

In order to make requests with this SDK you will need you master API token. This can be found through the Sendbird dashboard. Each app you create in Sendbird has its own master api token. These tokens can be found in Settings > Application > General. how to find you api token

šŸ’» Requirements

You will need Node.js installed. This has been developed and tested with NodeJS 17+.

āš™ļø Installation

🚨 Package not yet in npm 🚨 npm install sendbird-platform-sdk-typescript

šŸ¤“ Local Development

  1. Clone the repository
  2. cd to the sendbird-platform-sdk-typescript directory
  3. run npm install
  4. cd to your project directory
  5. run npm install /path/to/sendbird-platform-sdk-typescript --save

šŸ—ƒļø Documentation

All the documentation for this project lives in the /docs directory of this repo.

Helpful links
Documentation
Announcementdocs/AnnouncementApi.md
Applicationdocs/ApplicationApi.md
Botdocs/BotApi.md
GroupChanneldocs/GroupChannelApi.md
Messagedocs/MessageApi.md
OpenChanneldocs/OpenChannelApi.md
Userdocs/UserApi.md
Webhooksdocs/WebhooksApi.md