[对话]发送消息

请求参数

Header 参数

X-Fresns-App-Id

string

必需

密钥 App ID
密钥位置：控制面板->应用中心->应用密钥

默认值:

X-Fresns-Client-Platform-Id

integer

必需

平台编号，与密钥的「平台」匹配

默认值:

X-Fresns-Client-Version

string

必需

你的客户端版本号，推荐使用语义化版本号

默认值:

X-Fresns-Client-Device-Info

string

必需

交互设备信息 session_logs > device_info
压缩 Object 信息为字符串传参

默认值:

X-Fresns-Aid

string

可选

账号参数（留空则视为未登录账号）

默认值:

X-Fresns-Aid-Token

string

可选

账号身份凭证（传参 aid 时必传）

默认值:

X-Fresns-Uid

integer

可选

用户参数（留空则视为未登录用户）

默认值:

X-Fresns-Uid-Token

string

可选

用户身份凭证（传参 uid 时必传）

默认值:

X-Fresns-Signature

string

签名

必需

X-Fresns-Signature-Timestamp

string

必需

签名生成时间（当前 Unix 时间戳，精确到秒或毫秒都支持）

Body 参数application/json

uidOrUsername

string

必需

用户 uid 或者 username

message

string

消息内容

可选

fid

string

文件 FID

可选

示例

{
    "uidOrUsername": "string",
    "message": "string",
    "fid": "string"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://localhost:8080/api/v2/conversation/send-message' \
--header 'X-Fresns-App-Id;' \
--header 'X-Fresns-Client-Platform-Id;' \
--header 'X-Fresns-Client-Version;' \
--header 'X-Fresns-Client-Device-Info;' \
--header 'X-Fresns-Aid: ' \
--header 'X-Fresns-Aid-Token: ' \
--header 'X-Fresns-Uid: ' \
--header 'X-Fresns-Uid-Token: ' \
--header 'X-Fresns-Signature;' \
--header 'X-Fresns-Signature-Timestamp;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "uidOrUsername": "string",
    "message": "string",
    "fid": "string"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object (Message)

必需

id

number

消息 ID

必需

isMe

boolean

是否为自己发的

必需

type

string

必需

1.文本消息 2.文件消息

content

string

消息内容

必需

datetime

string

发送时间

必需

datetimeFormat

string

格式化的发送时间

必需

readStatus

string

阅读状态

必需

user

object (User)

发信用户信息

必需

file

object (FileInfo)

文件消息专用

必需

示例

{
    "code": 0,
    "message": "ok",
    "data": {
        "id": "Number / 消息 ID",
        "user": {
            // 发信用户信息
            // 通用数据结构->用户信息
        },
        "isMe": "Boolean / 是否为自己发的",
        "type": "Number / 1.文本消息 2.文件消息",
        "content": "String / 消息内容",
        "file": {
            // 文件消息专用
            // 通用数据结构->文件信息
        },
        "datetime": "String / 发送时间",
        "datetimeFormat": "String / 格式化的发送时间",
        "readStatus": "Boolean / 阅读状态"
    }
}