SDK
Java SDK
Maven io.starim:bot-sdk (0.1.13+). StarIMBot + StarIMBotClient は Bot Token ゲートウェイに合わせています。
依存関係
<dependency>
<groupId>io.starim</groupId>
<artifactId>bot-sdk</artifactId>
<version>0.1.13</version>
</dependency>
JDK 17+. パッケージ io.starim.botsdk.*. ローカルインストール: mvn -f botsdk/java clean install 中央が遅れている場合。
クイックウェブフックエコー
StarIMBot bot = StarIMBot.builder()
.token(System.getenv("STARIM_BOT_TOKEN"))
.baseUrl(System.getenv("STARIM_API_BASE"))
.secretToken(System.getenv("STARIM_WEBHOOK_SECRET"))
.build();
bot.on(UpdateType.MESSAGE, ctx -> {
String text = ctx.getMessage().getText();
if (text != null) ctx.reply(text, true);
});
bot.start(8787, "/webhook");
レイヤー
StarIMBot— ウェブフックサーバー + ポーリング + ルーティングStarIMBotClient— 直接HTTP API
client.sendMessage(new SendMessageParams("<chatId>", "hello"));
client.sendPhotoFromFile("<chatId>", Path.of("photo.jpg"), "cap");
例 (リポジトリと同じ — 実行可能)
ソース: botsdk/java/examples/ — EchoBot, SlashCommand, SendPhoto.
export STARIM_API_BASE="https://<api-host>/api/v1"
export STARIM_BOT_TOKEN="sbot_..."
export STARIM_WEBHOOK_SECRET="..."
bot.on(UpdateType.MESSAGE, ctx -> {
String text = ctx.getMessage().getText();
if (text != null) ctx.reply(text);
});
bot.start(8787, "/webhook");
bot.command("start", ctx -> ctx.reply("ようこそ"));
client.sendPhotoFromFile(chatId, Path.of("photo.png"), "キャプション");
bot.startPolling(30);
メソッドマップ
| エリア | SDK | ドキュメント |
|---|---|---|
| 送信 / ファイル | send*, sendPhotoFromFile | 送信 |
| 配信 | setWebhook, startPolling | ウェブフック |
| チャット | getMyChats, ピン/転送/コピー | チャット読み取り |
| オーケストレーション | simulateSendMessage | ガイド |
完全な契約: APIインデックス.
MediaUploadCacheは非推奨/無操作です。