获取指定消息

获取指定消息。

使用示例

  1. token := token.BotToken("appid", "token")
  2. api := botgo.NewOpenAPI(token).WithTimeout(3 * time.Second)
  3. ctx := context.Background()
  4. message, err := api.Message(ctx, channelId, msgId)
  5. if err != nil {
  6. log.Fatalln("调用 Message 接口失败, err = ", err)
  7. }

参数说明

参数 必填 类型 说明
channelId string 子频道 ID
msgId string 消息 ID

返回说明

参数 类型 说明
message Message 返回 message 对象

Message

字段名 类型 描述
ID string 消息 ID
ChannelID string 子频道 ID
GuildID string 频道 ID
Content string 消息内容
Timestamp Timestamp 消息创建时间,是个 iISO8601 timestamp 字符串,例:”2021-11-23T15:16:48+08:00”
Author User 消息创建者
Member Member 消息创建者的 member 信息

User

字段名 类型 描述
ID string 用户 ID
Username string 用户名
Avatar string 用户头像地址
Bot bool 是否是机器人
UnionOpenID string 特殊关联应用的 openid,需要特殊申请并配置后才会返回。如需申请,请联系平台运营人员。
UnionUserAccount string 机器人关联的互联应用的用户信息,与 union_openid 关联的应用是同一个。如需申请,请联系平台运营人员。

Member

字段名 类型 描述
GuildID string 频道ID
User User 用户基础信息,来自 QQ 资料,只有成员相关接口中会填充此信息
Nick string 用户在频道内的昵称
Roles string[] 用户在频道内的身份组 ID,默认值可参考DefaultRoleIDs
JoinedAt Timestamp 用户加入频道的时间,是个 ISO8601 timestamp 字符串,例:”2021-11-23T15:16:48+08:00”

DefaultRoleIDs

系统默认生成下列身份组 ID。

身份组 ID 默认值 描述
1 全体成员
2 管理员
4 群主/创建者
5 子频道管理员

Timestamp

字段名 类型 描述
Timestamp string 时间

返回示例

data:

  1. {
  2. "message": {
  3. "id": "abcdef01",
  4. "channel_id": "100001",
  5. "guild_id": "100000000001",
  6. "content": "hello",
  7. "timestamp": "2021-05-25T15:20:34+08:00",
  8. "author": {
  9. "id": "1000000001",
  10. "username": "az",
  11. "bot": false
  12. },
  13. "member": {
  14. "roles": ["1"],
  15. "joined_at": "2021-04-12T16:34:42+08:00"
  16. }
  17. }
  18. }