fresns

[通知]更新阅读状态

开发中

PUT

/api/v2/notification/mark-as-read

notificationType 和 notificationIds 二选一传参，不可同时传参。

type = all 使用 notificationType 参数，批量设置指定类型全部为已读。

type = choose 使用 notificationIds 参数，批量设置指定 ID 的消息为已读。

请求参数

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

type

string

必需

all 或 choose

notificationType

number

可选

0 全部类型设为已读（1~8)
1 系统通知 2 推荐内容 3 点赞 4 踩 5 关注 6 屏蔽 7 提及 8 评论

notificationIds

string

可选

消息 notifications->id，多个以英文逗号隔开

示例

{
  "type": "string",
  "notificationType": 0,
  "notificationIds": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'http://localhost:8080/api/v2/notification/mark-as-read' \
--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 '{
    "type": "string",
    "notificationType": 0,
    "notificationIds": "string"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

null

必需

示例

{
  "code": 0,
  "message": "ok",
  "data": null
}

修改于 2023-03-28 07:32:48

[通知]获取消息列表

[通知]删除消息