开源IM项目OpenIM发布消息推送api,支持应用与IM互通深度融合

简介: 开源IM项目OpenIM发布消息推送api,支持应用与IM互通深度融合

以办公场景为例,比如员工入职通知,放假通知等业务通知,由oa系统处理具体的业务逻辑,再调用消息推送api,触达到目标用户。

效果示例

以协同办公为例,员工收到系统推送的工作通知,有新任务需要处理。

640.png

员工点击工作通知,可以查看具体详情,每条通知有不同的发送者昵称和头像。这种通知类型是一种新的会话类型,全部聚合在同一个会话。

640-1.png

OpenIM简介
OpenIM:从服务端到客户端SDK开源即时通讯整体解决方案。开发者可以轻松替代第三方IM云服务,打造具备聊天、社交功能的app,也可以在自身应用中集成SDK,以提供即时通讯能力。开源IM的价值在于“一切皆可控”“我的信息我做主”,无论是技术,还是信息安全。

整体超过7.2K star,OpenIM作为开源IM的领跑者,持续添加新功能,包括消息推送api,群聊已读。服务端和sdk都是Apache-2.0 License授权协议,可以免费使用。带有UI的产品需要商业授权,有兴趣的客户可以联系我们深度交流。

5X8小时vip专属服务,包括:
(1)一对一技术咨询,微信 电话等各种方式;
(2)sdk使用辅导咨询;
(3)服务端架构及部署答疑;
(4)IM新需求优先排期;
(5)bug优先修复;
(6)系统维护和故障响应;
web端体验:https://open-im-online.rentsoft.cn/

安卓端体验:https://www.pgyer.com/OpenIM

iOS端体验:

https://testflight.apple.com/join/o956rTGx

640-2.png

单机性能及容量总结

服务器资源:8核16G内存, 6个机械磁盘,每个磁盘100G, mongo 分片,10MB带宽。

容量:用户同时在线10万以上,消息条数10亿。

性能评估:同时在线用户10万,每秒钟发送消息900条,(从发送者发出消息到接收到消息)消息延时1秒

可靠性总结

每条消息都能被对方精确收到,并成功落地app本地db。对于失败的3条消息,接收方确实没有收到,确保系统消息一致性。

系统具备优秀的平行扩展能力,除存储模块外,其他模块都无状态,支持亿级用户,千亿消息量。

github地址:https://github.com/OpenIMSDK/Open-IM-Server

开发者中心:https://doc.rentsoft.cn/#/

简要描述

管理员通过后台接口发送通知类型消息

请求URL

http://x.x.x.x:10000/manager/send_msg

请求方式

POST

请求示例

{
"operationID": "Oa notification operationID111",
"sendID": "openIM123456",
"recvID": "18712345678",
"senderPlatformID": 2,
"senderFaceURL": "http://www.head.com",
"senderNickname": "系统通知2",
"content": {

   "notificationName": "公文管理", 
   "notificationFaceURL": "http://www.head1.com", 
   "notificationType": 1, 
   "text": "大家好,今天是...", 
   "externalUrl":"",
   "mixType": 0, 
   "pictureElem": {
       "sourcePath": "", 
       "sourcePicture": {
           "uuid": "", 
           "type": "", 
           "size": 0, 
           "width": 0, 
           "height": 0, 
           "url": ""
      }, 
       "bigPicture": {
           "uuid": "", 
           "type": "", 
           "size": 0, 
           "width": 0, 
           "height": 0, 
           "url": ""
      }, 
       "snapshotPicture": {
           "uuid": "", 
           "type": "", 
           "size": 0, 
           "width": 0, 
           "height": 0, 
           "url": ""
      }
  }, 
   "soundElem": {
       "uuid": "", 
       "soundPath": "", 
       "sourceUrl": "", 
       "dataSize": 0, 
       "duration": 0
  }, 
   "videoElem": {
       "videoPath": "", 
       "videoUUID": "", 
       "videoUrl": "", 
       "videoType": "", 
       "videoSize": 0, 
       "duration": 0, 
       "snapshotPath": "", 
       "snapshotUUID": "", 
       "snapshotSize": 0, 
       "snapshotUrl": "", 
       "snapshotWidth": 0, 
       "snapshotHeight": 0
  }, 
   "fileElem": {
       "filePath": "", 
       "uuid": "", 
       "sourceUrl": "", 
       "fileName": "", 
       "fileSize": 0
  }, 
   "ex": ""

},
"contentType": 1400,
"sessionType": 4,
"isOnlineOnly": false,
"offlinePushInfo": {

   "title": "admin revoke your message", 
   "desc": "", 
   "ex": "", 
   "iOSPushSound": "default", 
   "iOSBadgeCount": false

}
}Copy to clipboardErrorCopied
请求参数

参数名 类型 必选 说明
operationID string 是 操作ID,保持唯一,建议用当前时间微秒+随机数,用于后台链路追踪问题使用
sendID string 是 管理员ID,为后台config文件中配置的管理员ID中一个,默认openIM123456
recvID string 是 接收者userID
senderPlatformID int 否 发送者平台号,模拟用户发送时填写, 1->IOS,2->Android,3->Windows,4->OSX,5->Web,5->MiniWeb,7->Linux
senderFaceURL string 否 发送者头像,用于客户端通知会话产生
senderNickname string 否 发送者昵称,用于客户端通知会话产生
content object 是 消息的具体内容,内部是json 对象
notificationName string 是 通知标题
notificationFaceURL string 是 通知头像
notificationType int 是 通知类型,如:1代表入职通知,2代表离职通知
text string 是 通知正文e
externalUrl string 否 通知点击后需要跳转到的地址链接(不填则无需跳转)
mixType int 是 通知混合类型 0:纯文字通知 1:文字+图片通知 2:文字+视频通知 3:文字+文件通知
pictureElem object 否 图片元素对象
sourcePicture object 否 原图
bigPicture object 否 大图
snapshotPicture object 否 缩略图
soundElem object 否 声音元素对象
videoElem object 否 视频元素对象
fileElem object 否 文件元素对象
uuid string 否 对象唯一ID用于缓存使用
type/videoType/ string 否 图片类型/视频类型
size/dataSize/videoSize/snapshotSize/fileSize int 否 多媒体文件大小,单位字节
width/snapshotWidth int 否 图片/视频缩略图宽度
height/snapshotHeight int 否 图片/视频缩略图高度
url/sourceUrl/videoUrl string 否 图片/文件/视频的URL
sourcePath/soundPath/videoPath/filePath string 否 文件路径,可不填写
fileName string 否 文件名字
ex string 否 扩展字段
contentType int 是 消息类型固定为1400
sessionType int 是 通知会话类型固定为4
isOnlineOnly bool 否 改字段设置为true时候,发送的消息服务器不会存储,接收者在线才会收到,不在线该消息丢失。
offlinePushInfo object 否 离线推送的具体内容,如果不填写,使用服务器默认推送标题
title string 否 推送的标题
desc string 否 推送的具体描述
ex string 否 扩展字段
iOSPushSound string 否 IOS的推送声音
iOSBadgeCount bool 否 IOS推送消息是否计入桌面图标未读数
返回示例

{
"errCode": 0,
"errMsg": "",
"data": {

 "serverMsgID": "", 
 "clientMsgID": "", 
 "sendTime": 1645697804432

}
}Copy to clipboardErrorCopied
返回参数

参数名 类型 说明
errCode int 0成功,非0失败
errMsg string 错误信息
sendTime int 消息发送的具体时间,具体为毫秒的时间戳
serverMsgID string 服务器生成的消息的唯一ID
clientMsgID string 客户端生成的消息唯一ID,默认情况使用这个为主键
消息类型格式描述

简要描述

管理员消息发送字段中contentType支持的消息类型说明以及消息content的具体字段说明。

ContentType消息类型说明

ContentType值 类型说明
101 文本消息
102 图片消息
103 音频消息
104 视频消息
105 文件消息
106 群聊中的@类型消息
107 合并转发类型消息
108 名片消息
109 地理位置类型消息
110 自定义消息
111 撤回类型消息
112 已读回执类型消息
114 引用类型消息
Content具体内容

content内部为具体的json对象,不同的消息类型是不同的json对象

文本消息

{
...,
"content": {

 "text": "nihao"

},
....
}Copy to clipboardErrorCopied
参数名 必选 类型 说明
text 是 string 文本消息的具体内容
自定义消息

{
...,
"content": {

 "data": "", 
 "description": "", 
 "extension": ""

},
....
}Copy to clipboardErrorCopied
参数名 类型 必选 说明
data json string 是 用户自定义的消息为json对象转换后的string
description json string 否 扩展的描述信息为json对象转换后的string,可以不使用
extension json string 否 扩展字段,暂时不使用

目录
相关文章
|
10天前
|
弹性计算 算法 安全
视觉智能开放平台产品使用合集之在Web应用和WinForm应用程序中调用API时,出现Web端能够成功调用而WinForm端调用失败,是什么原因
视觉智能开放平台是指提供一系列基于视觉识别技术的API和服务的平台,这些服务通常包括图像识别、人脸识别、物体检测、文字识别、场景理解等。企业或开发者可以通过调用这些API,快速将视觉智能功能集成到自己的应用或服务中,而无需从零开始研发相关算法和技术。以下是一些常见的视觉智能开放平台产品及其应用场景的概览。
|
2月前
|
自然语言处理 Java API
Java 8的Stream API和Optional类:概念与实战应用
【5月更文挑战第17天】Java 8引入了许多重要的新特性,其中Stream API和Optional类是最引人注目的两个。这些特性不仅简化了集合操作,还提供了更好的方式来处理可能为空的情况,从而提高了代码的健壮性和可读性。
64 7
|
7天前
|
运维 Serverless API
Serverless 应用引擎产品使用合集之通过 API 调用 /tagger/v1/interrogate 时,出现unsupported protocol scheme "" 错误,如何处理
阿里云Serverless 应用引擎(SAE)提供了完整的微服务应用生命周期管理能力,包括应用部署、服务治理、开发运维、资源管理等功能,并通过扩展功能支持多环境管理、API Gateway、事件驱动等高级应用场景,帮助企业快速构建、部署、运维和扩展微服务架构,实现Serverless化的应用部署与运维模式。以下是对SAE产品使用合集的概述,包括应用管理、服务治理、开发运维、资源管理等方面。
|
27天前
|
移动开发 监控 API
WebSocket API 详解与应用指南
WebSocket API 是HTML5的一种技术,它允许服务器与客户端建立持久的全双工连接,改变传统HTTP请求-响应模式,实现双向通信。API包括WebSocket构造函数、连接状态属性(如readyState)、方法(如send和close)及事件(如onopen和onmessage)。它简化了实时Web应用程序的开发,适用于在线聊天、实时数据监控等场景。
51 5
|
4天前
|
数据采集 自然语言处理 算法
淘宝评论的 API 接口获取:技术探索与应用
这篇文稿探讨了淘宝评论API在数据驱动的商业环境中的重要性。API接口使得高效、精准地获取淘宝评论成为可能,帮助企业分析消费者反馈、优化产品和服务,以及训练智能算法。通过API,商家能实时监控评论以快速响应市场变化,同时确保数据合规性和安全性。然而,获取和使用数据涉及复杂的接口调用、数据清洗、反爬虫机制应对等挑战。通过实际案例,展示了API如何促进产品优化、市场研究和智能客服改进。随着技术发展,未来将有更多创新应用,但也需面对更严格的法规监管。
|
26天前
|
JavaScript 关系型数据库 Serverless
Serverless 应用引擎操作报错合集之在调用stable Diffusion函数计算api接口返回,报错:"Not Found"一般是什么原因
Serverless 应用引擎(SAE)是阿里云提供的Serverless PaaS平台,支持Spring Cloud、Dubbo、HSF等主流微服务框架,简化应用的部署、运维和弹性伸缩。在使用SAE过程中,可能会遇到各种操作报错。以下是一些常见的报错情况及其可能的原因和解决方法。
|
1月前
|
API 网络架构 数据格式
API接口详解及其在电子商务中的应用研究
本文介绍了API接口在电子商务中的重要性,详细阐述了API的定义、分类(RESTful, SOAP, GraphQL)和设计原则。通过实例展示了API如何促进数据交换和系统集成,如商品信息共享、订单自动化处理。同时,讨论了API安全性措施,并提供了一个Python代码示例来演示如何获取电商平台的商品信息。API在电子商务领域的应用对于提升业务效率和推动行业创新具有显著影响。
|
13天前
|
缓存 Java API
使用GraphQL优化Java应用的API性能
使用GraphQL优化Java应用的API性能
|
19天前
|
机器学习/深度学习 自然语言处理 搜索推荐
自然语言处理在智能客服系统中的应用
自然语言处理在智能客服系统中的应用
23 0
|
19天前
|
JSON API 数据安全/隐私保护
闲鱼商品详情API:深入解析与应用指南
闲鱼商品详情API助力提升交易体验,提供商品全貌,包括价格、描述、图片等实时信息,增强买卖双方信任。开发者可通过接口获取商品基本信息、描述、图片、分类等,用于构建推荐、比价系统。接口调用示例展示了如何获取商品数据,如价格、位置、卖家信息等,以JSON格式返回,便于集成到应用中,促进高效交易。