Developer Hub
Relation ProtocolRelation ONE APIRelation Graph API
中文
中文
  • 概述
    • Relation ONE
  • 开发指引
    • 名词解释
    • 服务地址
    • 鉴权与限流
    • JS-SDK使用说明
    • 快速开始
  • Relation ONE IM 介绍
  • API
    • 介绍
    • 签名认证
    • 登录认证
    • 用户信息
      • 绑定地址
      • 解绑地址
      • 用户信息
      • 查询地址
      • 查询Web2账户
    • 好友关系
      • 关注
      • 取关
      • 粉丝列表
      • 关注列表
      • 根据Web3地址查询粉丝列表
      • 根据Web3地址查询关注列表
    • 用户推荐
    • 群组管理
      • 创建
      • 加入
      • 移除
      • 离开
      • 解散
      • 转移管理员
      • 详情
      • 成员列表
      • 是否为管理员
      • 查询群公告
      • 设置群公告
    • 聊天管理
      • 置顶
      • 免打扰
      • 列表
      • 隐藏
    • 消息管理
      • 发消息
      • 读消息
      • 删除消息
      • 消息列表
      • 未读消息数
  • JS-SDK
    • Relation-Auth
      • 快速开始
      • 方法
    • IM-JS-SDK
      • 快速开始
      • 静态方法
      • 事件
      • 方法
      • 消息解析
    • Plugin-JS-SDK
      • 快速开始
  • 附录
    • 接口错误码
    • 合约列表
Powered by GitBook
On this page
  1. API
  2. 消息管理

发消息

POST api/v1/message/send

  • 说明:发送消息。

  • Header

Field
Type
Remarks

ApiKey

String

Authorization

String

Bearer ${unifiedAuthToken} ,其中unifiedAuthToken来自/api/v1/auth接口的返回

  • Request Parameters

Field
Type
Remarks

channelUuid

String

选填,与toRelationId 至少有一个不为空。群组uuid

toRelationId

String

选填,与channelUuid 至少有一个不为空。对方的relationId

type

String

消息类型,当前系统默认的三种类型:text;sys;card,用户可自行扩展

content

String

消息内容

sendUuid

String

消息uuid,由客户端生成维护

quoteId

String

引用的消息id

mentionedUser

Array[String]

提及的用户relationId集合

  • Request Example

curl POST 'https://api.relationlabs.ai/api/v1/message/send' \
--header 'ApiKey: <ApiKey>' \
--header 'Authorization: bearer eyJhbG1ciOiJFUzI1NiJ9.eyJqdGkiOiI0MzdiN2EzZDEwMGY0ODVkOWVhMWUzZmZlOWE1NmEyZSIsImlzcyI6InJlbGF0aW9ubGFicy5haSIsImlhdCI6MTY2NTIxNTUzNSwic3ViIjoiZGhreXEtc3FhYWEtYWFhYWotc2d6M3EtY2FpIiwiZXhwIjoxNjY11ODIwMzM1fQ.rj7KKuIcgmvaIwZ63YHnXQ4jvvI-eR2Wo7k3YEyz1Muxo8j5ezCowKDpcW0u9zIuHPFqwD0-1XPWdPLR1d1HLFw' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "TEXT",
    "channelUuid": "4f326124812c41448bc587bf6b2eaf42",
    "toRelationId": null,
    "content": "hello",
    "sendUuid": "1u4dp-6qaaa-aaaaj-aag4q-cai-87b4c789ee444d28960dfdd9b208d1ef-1665371575954-35534417409750164",
    "quoteId":1579047130798100481,
    "mentionedUser":["1u4dp-6qaaa-aaaaj-aag4q-cai"]
}'
  • Response Parameters

Field
Type
Remarks

code

String

返回码

desc

String

返回信息

data

SendMessageResponse

数据

The SendMessageResponse field consists of the following subfields:

Field
Type
Remarks

id

String

消息的唯一id

channelUuid

String

群组的uuid

  • Response Body

{
    "code": "0",
    "desc": "success",
    "data": {
        "channelUuid": "4f326124812c41448bc587bf6b2eaf42",
        "id": "1579309168845799425"
    }
}
  • Return Code

code
desc
Remarks

0

success

接口调用成功

10112

parameter error

channelUuid和toRelationId不能同时为空

13301

block stranger messages

对方开启了禁止陌生人聊天模式

13108

Not the member of this group

非群组成员,无权限发送消息

Previous消息管理Next读消息

Last updated 2 years ago

从管理员获取的

ApiKey