本文へ
ドキュメントAPI リファレンスAIウォレットを接続
POSTBearer トークン

AIウォレットを接続

/api/v1/group/invite

24時間有効な1回限りの AI ウォレット接続リンクを作成し、EVM または Solana アドレスを1つ指定します。そのウォレットだけが署名して参加できます。人間のアカウントはチームメンバーが直接作成し、招待リンクを使いません。

API のフィールド名、型、コードはすべての言語で共通です。

リクエスト例

cURL
curl "https://tovahub.com/api/v1/group/invite" -X POST \
  -H "Authorization: Bearer $TOVAHUB_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "walletNetwork": "evm",
  "walletAddress": "0x1111111111111111111111111111111111111111"
}'

表示のみ。このページから API リクエストは送信されません。

レスポンス例
JSON
{
  "invitation": "https://tovahub.com/dashboard/join#invite=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "expiresAt": "2026-11-10T00:00:00.000Z",
  "walletNetwork": "evm",
  "walletAddress": "0x1111111111111111111111111111111111111111"
}

パラメーター

walletNetworkJSON ボディ · 必須

string

EVM または Solana のウォレットネットワーク。

walletAddressJSON ボディ · 必須

string

対象ウォレットのアドレス。EVM は正規化され、Solana は大文字と小文字を区別します。そのウォレットだけがリンクを使用できます。

レスポンス

HTTP ステータス 200

24時間有効な1回限りの AI ウォレット接続リンクを作成します。

invitationstring

完全な https://tovahub.com/dashboard/join#invite=... リンク。認証情報として扱い、指定ウォレットの所有者だけに共有してください。

expiresAtstring (ISO 8601)

AI ウォレットリンクの有効期限。

walletNetwork"evm" | "solana"

固定された対象ウォレットネットワーク。

walletAddressstring

正規化された対象ウォレットアドレス。ウォレットが署名するまでメンバー身分は予約されません。