Sharkey/README.md

111 lines
2.9 KiB
Markdown
Raw Normal View History

2021-05-14 05:54:41 +03:00
# misskey.js
2021-05-16 18:07:01 +03:00
**Strongly-typed official Misskey SDK for browsers/Node.js.**
2021-05-23 11:17:14 +03:00
[![NPM](https://nodei.co/npm/misskey-js.png?downloads=true&downloadRank=true&stars=true)](https://www.npmjs.com/package/misskey-js)
2021-05-16 18:07:01 +03:00
JavaScript(TypeScript)用の公式MisskeySDKです。ブラウザ/Node.js上で動作します。
以下が提供されています:
- ユーザー認証
- APIリクエスト
- ストリーミング
- ユーティリティ関数
- Misskeyの各種モデル(ノート、ユーザー等)の型定義
2021-05-14 05:54:41 +03:00
2021-05-14 06:00:58 +03:00
## Install
2021-05-23 11:16:14 +03:00
```
npm i misskey-js
```
2021-05-14 06:00:58 +03:00
2021-05-14 05:54:41 +03:00
# Usage
2021-05-16 12:30:42 +03:00
## Authenticate
todo
2021-05-14 05:54:41 +03:00
## API request
2021-05-16 12:27:21 +03:00
``` ts
import * as Misskey from 'misskey-js';
const cli = new Misskey.api.APIClient({
2021-05-23 06:15:28 +03:00
origin: 'https://misskey.test',
credential: 'TOKEN',
2021-05-16 12:27:21 +03:00
});
const meta = await cli.request('meta', { detail: true });
```
2021-05-14 05:54:41 +03:00
## Streaming
2021-05-16 12:33:08 +03:00
``` ts
import * as Misskey from 'misskey-js';
const stream = new Misskey.Stream('https://misskey.test', { token: 'TOKEN' });
2021-05-23 07:34:36 +03:00
const mainChannel = stream.useChannel('main');
2021-05-16 12:33:08 +03:00
mainChannel.on('notification', notification => {
console.log('notification received', notification);
});
```
2021-05-14 06:00:10 +03:00
2021-05-23 07:34:36 +03:00
### チャンネルへの接続
チャンネルへの接続は`useChannel`メソッドを使用します。
2021-05-16 16:23:23 +03:00
2021-05-23 07:34:36 +03:00
パラメータなし
2021-05-17 18:07:17 +03:00
``` ts
const stream = new Misskey.Stream('https://misskey.test', { token: 'TOKEN' });
2021-05-23 07:34:36 +03:00
const mainChannel = stream.useChannel('main');
2021-05-17 18:07:17 +03:00
```
2021-05-23 07:34:36 +03:00
パラメータあり
2021-05-17 18:07:17 +03:00
``` ts
const stream = new Misskey.Stream('https://misskey.test', { token: 'TOKEN' });
2021-05-23 07:34:36 +03:00
const messagingChannel = stream.useChannel('messaging', {
2021-05-17 18:07:17 +03:00
otherparty: 'xxxxxxxxxx',
});
```
### チャンネルから切断
`dispose`メソッドを呼び出します。
``` ts
const stream = new Misskey.Stream('https://misskey.test', { token: 'TOKEN' });
2021-05-23 07:34:36 +03:00
const mainChannel = stream.useChannel('main');
2021-05-17 18:07:17 +03:00
mainChannel.dispose();
```
2021-05-16 16:23:23 +03:00
### メッセージの受信
チャンネル接続インスタンスはEventEmitterを継承しており、メッセージがサーバーから受信されると受け取ったイベント名でペイロードをemitします。
2021-05-17 18:07:17 +03:00
``` ts
import * as Misskey from 'misskey-js';
const stream = new Misskey.Stream('https://misskey.test', { token: 'TOKEN' });
2021-05-23 07:34:36 +03:00
const mainChannel = stream.useChannel('main');
2021-05-17 18:07:17 +03:00
mainChannel.on('notification', notification => {
console.log('notification received', notification);
});
```
2021-05-16 16:23:23 +03:00
### メッセージの送信
チャンネル接続インスタンスの`send`メソッドを使用してメッセージをサーバーに送信することができます。
2021-05-17 18:07:17 +03:00
``` ts
import * as Misskey from 'misskey-js';
const stream = new Misskey.Stream('https://misskey.test', { token: 'TOKEN' });
2021-05-23 07:34:36 +03:00
const messagingChannel = stream.useChannel('messaging', {
2021-05-17 18:07:17 +03:00
otherparty: 'xxxxxxxxxx',
});
messagingChannel.send('read', {
id: 'xxxxxxxxxx'
});
```
2021-05-14 06:00:58 +03:00
---
2021-05-14 06:00:10 +03:00
<div align="center">
<a href="https://github.com/misskey-dev/misskey/blob/develop/CONTRIBUTING.md"><img src="./i-want-you.png" width="300"></a>
</div>