一起听 - 接受邀请

使用房间 ID 和邀请者 ID 加入一起听房间。

接口信息

项目	值
接口地址	/listentogether/accept
请求方式	GET / POST
需要登录	是
对应模块	listentogether_accept
文档分类	一起听
上游路径	/api/listen/together/play/invitation/accept

请求参数

参数	类型	必填	默认值	说明
roomId	string	✅	-	房间 ID
inviterId	string	✅	-	邀请者，也就是房主的用户 ID

当前实现会额外固定带上 refer=inbox_invite，不需要手动传入。

HTTP 示例

POST /listentogether/accept?roomId=MzA0NjY5...&inviterId=32953014

编程式调用

import { listentogetherAccept } from 'hana-music-api';

const result = await listentogetherAccept({
  roomId: 'MzA0NjY5...',
  inviterId: '32953014',
});

console.log(result.body);

返回关注点

• code: 是否加入成功。
• message: 失败时的错误信息。
• 实际接入时通常在成功后立刻补调其他接口拉取房间和歌单状态。

返回内容

body.code 收紧为 200；data（含 data.roomInfo）和 message 整体宽松。没有第二账号的真实邀请，成功路径只录到接受自己房间时的 ALREADY_IN_ROOM，新加入成员的正文没有证据；接受已结束房间返回 code: 488，按业务拒绝原样转交。

调用顺序

1. 从分享链接中拿到 roomId 和 inviterId。
2. 调用本接口接受邀请。
3. 调用 /listentogether/room/check 检查房间是否可加入。
4. 调用 /listentogether/sync/playlist/get 拉取当前房间的播放列表。
5. 轮询或按需调用 /listentogether/status 获取成员和当前房间状态。