API クライアント

概要

Client は 8 つの RPC メソッドを提供する gRPC API クライアントです。

セットアップ

npm

// ESM
import { OAuth2Authenticator, Client, MediaUploadType, LanguageCode } from 'mixi2-js';
// CJS
const { OAuth2Authenticator, Client, MediaUploadType, LanguageCode } = require('mixi2-js');

JSR

import { OAuth2Authenticator, Client, MediaUploadType, LanguageCode } from '@otoneko1102/mixi2-js';

const authenticator = new OAuth2Authenticator({
  clientId: process.env.CLIENT_ID!,
  clientSecret: process.env.CLIENT_SECRET!,
  tokenUrl: process.env.TOKEN_URL!,
});

const client = new Client({
  apiAddress: process.env.API_ADDRESS!,
  authenticator,
});

プロパティ	型	必須	説明
apiAddress	string	○	API サーバーアドレス
authenticator	Authenticator	○	認証インスタンス

RPC メソッド一覧

メソッド	引数	戻り値	説明
getUsers(userIdList)	string[]	Promise<User[]>	ユーザー情報を一括取得
getPosts(postIdList)	string[]	Promise<Post[]>	ポスト情報を一括取得
createPost(request)	CreatePostRequest	Promise<Post>	ポストを作成（返信/引用/メディア添付対応）
initiatePostMediaUpload(request)	InitiatePostMediaUploadRequest	Promise<InitiatePostMediaUploadResponse>	メディアアップロードを開始
getPostMediaStatus(mediaId)	string	Promise<GetPostMediaStatusResponse>	メディアの処理状況を取得
sendChatMessage(request)	SendChatMessageRequest	Promise<ChatMessage>	チャットメッセージを送信
getStamps(request?)	GetStampsRequest?	Promise<OfficialStampSet[]>	スタンプ一覧を取得
addStampToPost(postId, stampId)	string, string	Promise<Post>	ポストにスタンプを付与
close()	-	void	gRPC 接続を閉じる

使用例

ユーザー情報取得

const users = await client.getUsers(['user-id-1', 'user-id-2']);

ポスト作成

const post = await client.createPost({ text: 'Hello mixi2!' });

CreatePostRequest

フィールド	型	必須	説明
text	string	○	ポスト本文（最大 149 文字）
inReplyToPostId	string	-	返信先ポスト ID
quotedPostId	string	-	引用対象ポスト ID
mediaIdList	string[]	-	添付メディア ID（最大 4 件）
postMask	PostMask	-	マスク設定（センシティブ/ネタバレ）
publishingType	PostPublishingType	-	配信設定

ノート

inReplyToPostId と quotedPostId は同時に指定できません。

メディアアップロード → ポスト添付

const upload = await client.initiatePostMediaUpload({
  contentType: 'image/png',
  dataSize: 1024,
  mediaType: MediaUploadType.IMAGE,
});
// upload.uploadUrl に POST でメディアデータを送信
const status = await client.getPostMediaStatus(upload.mediaId);
// status.status === MediaUploadStatus.COMPLETED になったら添付可能
await client.createPost({ text: '画像付き！', mediaIdList: [upload.mediaId] });

InitiatePostMediaUploadRequest

フィールド	型	必須	説明
contentType	string	○	Content-Type（例: image/jpeg）
dataSize	number	○	データサイズ（バイト）
mediaType	MediaUploadType	○	メディア種別（IMAGE / VIDEO）
description	string	-	メディアの説明

チャットメッセージ送信

const message = await client.sendChatMessage({
  roomId: 'room-id',
  text: 'Hello!',
});

SendChatMessageRequest

フィールド	型	必須	説明
roomId	string	○	送信先ルーム ID
text	string	△	テキスト（text または mediaId のいずれか必須）
mediaId	string	△	添付メディア ID

注意

チャットメッセージはユーザーからの DM 受信後にのみ送信可能です。

スタンプ

// スタンプ一覧取得
const stamps = await client.getStamps({ officialStampLanguage: LanguageCode.JP });

// ポストにスタンプを付与
await client.addStampToPost('post-id', 'stamp-id');

接続の終了

client.close();

各 RPC メソッドの詳細は 公式 API 仕様 を参照してください。