差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 后一修订版 两侧同时换到之后的修订记录 | ||
|
im:server:basics:messages [2020/03/27 09:21] huanxinfudh |
im:server:basics:messages [2020/07/28 07:06] huanxinfudh [发送透传消息] |
||
|---|---|---|---|
| 行 13: | 行 13: | ||
| 给一个或者多个用户，或者一个或者多个群组发送消息，并且通过可选的 from 字段让接收方看到发送方是不同的人。同时，支持扩展字段，通过 ext 属性，APP 可以发送自己专属的消息结构。 | 给一个或者多个用户，或者一个或者多个群组发送消息，并且通过可选的 from 字段让接收方看到发送方是不同的人。同时，支持扩展字段，通过 ext 属性，APP 可以发送自己专属的消息结构。 | ||
| <WRAP clear/> | <WRAP clear/> | ||
| - | **注意**：在调用程序中，请求体如果超过 5kb 会导致413错误，需要拆成几个更小的请求体重试，同时用户消息+扩展字段的长度在40k字节以内。详见[[im:server:help:restastrict|接口限流说明]]。 | + | **注意**：在调用程序中，请求体如果超过 5kb 会导致413错误，需要拆成几个更小的请求体重试，同时用户消息+扩展字段的长度在4k字节以内。详见[[im:server:help:restastrict|接口限流说明]]。 |
| === HTTP Request === | === HTTP Request === | ||
| 行 29: | 行 29: | ||
| ^参数^说明^ | ^参数^说明^ | ||
| |target_type|发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息| | |target_type|发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息| | ||
| - | |target|发送的目标；注意这里需要用数组，即使只有一个用户，也要用数组 ['u1']；给用户发送时数组元素是用户名，给群组发送时，数组元素是groupid| | + | |target|发送的目标；注意这里需要用数组，并且向数组内添加的用户不能超过1000个，即使只有一个用户，也要用数组 ['u1']；给用户发送时数组元素是用户名，给群组发送时，数组元素是groupid| |
| |msg|消息内容| | |msg|消息内容| | ||
| |type|消息类型；txt:文本消息，img：图片消息，loc：位置消息，audio：语音消息，video：视频消息，file：文件消息| | |type|消息类型；txt:文本消息，img：图片消息，loc：位置消息，audio：语音消息，video：视频消息，file：文件消息| | ||
| 行 115: | 行 115: | ||
| ^参数^说明^ | ^参数^说明^ | ||
| |target_type|发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息| | |target_type|发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息| | ||
| - | |target|发送的目标；注意这里需要用数组，即使只有一个用户，也要用数组 ['u1']；给用户发送时数组元素是用户名，给群组发送时，数组元素是groupid| | + | |target|发送的目标；注意这里需要用数组，并且向数组内添加的用户不能超过1000个，即使只有一个用户，也要用数组 ['u1']；给用户发送时数组元素是用户名，给群组发送时，数组元素是groupid| |
| |msg|消息内容| | |msg|消息内容| | ||
| |type|消息类型；txt:文本消息，img：图片消息，loc：位置消息，audio：语音消息，video：视频消息，file：文件消息| | |type|消息类型；txt:文本消息，img：图片消息，loc：位置消息，audio：语音消息，video：视频消息，file：文件消息| | ||
| - | |url|成功上传文件返回的UUID| | + | |url|域名/orgname/appname/chatfiles/成功上传文件返回的UUID。参考请求示例| |
| |filename|图片名称| | |filename|图片名称| | ||
| |secret|成功上传文件后返回的secret| | |secret|成功上传文件后返回的secret| | ||
| 行 206: | 行 206: | ||
| ^参数^说明^ | ^参数^说明^ | ||
| |target_type|发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息| | |target_type|发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息| | ||
| - | |target|发送的目标；注意这里需要用数组，即使只有一个用户，也要用数组 ['u1']；给用户发送时数组元素是用户名，给群组发送时，数组元素是groupid| | + | |target|发送的目标；注意这里需要用数组，并且向数组内添加的用户不能超过1000个，即使只有一个用户，也要用数组 ['u1']；给用户发送时数组元素是用户名，给群组发送时，数组元素是groupid| |
| |msg|消息内容| | |msg|消息内容| | ||
| |type|消息类型；txt:文本消息，img：图片消息，loc：位置消息，audio：语音消息，video：视频消息，file：文件消息| | |type|消息类型；txt:文本消息，img：图片消息，loc：位置消息，audio：语音消息，video：视频消息，file：文件消息| | ||
| 行 296: | 行 296: | ||
| ^参数^说明^ | ^参数^说明^ | ||
| |target_type|发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息| | |target_type|发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息| | ||
| - | |target|发送的目标；注意这里需要用数组，即使只有一个用户，也要用数组 ['u1']；给用户发送时数组元素是用户名，给群组发送时，数组元素是groupid| | + | |target|发送的目标；注意这里需要用数组，并且向数组内添加的用户不能超过1000个，即使只有一个用户，也要用数组 ['u1']；给用户发送时数组元素是用户名，给群组发送时，数组元素是groupid| |
| |type|消息类型；txt:文本消息，img：图片消息，loc：位置消息，audio：语音消息，video：视频消息，file：文件消息| | |type|消息类型；txt:文本消息，img：图片消息，loc：位置消息，audio：语音消息，video：视频消息，file：文件消息| | ||
| |filename|视频文件名称| | |filename|视频文件名称| | ||
| 行 369: | 行 369: | ||
| 位置消息：获取到地址的经纬度，填写正确地址发送。 | 位置消息：获取到地址的经纬度，填写正确地址发送。 | ||
| <WRAP clear/> | <WRAP clear/> | ||
| - | **注意**：在调用程序中，请求体如果超过 5kb 会导致413错误，需要拆成几个更小的请求体重试，同时用户消息+扩展字段的长度在40k字节以内。详见[[im:server:help:restastrict|接口限流说明]]。 | + | **注意**：在调用程序中，请求体如果超过 5kb 会导致413错误，需要拆成几个更小的请求体重试，同时用户消息+扩展字段的长度在4k字节以内。详见[[im:server:help:restastrict|接口限流说明]]。 |
| === HTTP Request === | === HTTP Request === | ||
| 行 385: | 行 385: | ||
| ^参数^说明^ | ^参数^说明^ | ||
| |target_type|发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息| | |target_type|发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息| | ||
| - | |target|发送的目标；注意这里需要用数组，即使只有一个用户，也要用数组 ['u1']；给用户发送时数组元素是用户名，给群组发送时，数组元素是groupid| | + | |target|发送的目标；注意这里需要用数组，并且向数组内添加的用户不能超过1000个，即使只有一个用户，也要用数组 ['u1']；给用户发送时数组元素是用户名，给群组发送时，数组元素是groupid| |
| |msg|消息内容| | |msg|消息内容| | ||
| |type|消息类型；txt:文本消息，img：图片消息，loc：位置消息，audio：语音消息，video：视频消息，file：文件消息| | |type|消息类型；txt:文本消息，img：图片消息，loc：位置消息，audio：语音消息，video：视频消息，file：文件消息| | ||
| 行 470: | 行 470: | ||
| ^参数^说明^ | ^参数^说明^ | ||
| |target_type|发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息| | |target_type|发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息| | ||
| - | |target|发送的目标；注意这里需要用数组，即使只有一个用户，也要用数组 ['u1']；给用户发送时数组元素是用户名，给群组发送时，数组元素是groupid| | + | |target|发送的目标；注意这里需要用数组，并且向数组内添加的用户不能超过1000个，即使只有一个用户，也要用数组 ['u1']；给用户发送时数组元素是用户名，给群组发送时，数组元素是groupid| |
| |msg|消息内容| | |msg|消息内容| | ||
| |type|消息类型；txt:文本消息，img：图片消息，loc：位置消息，audio：语音消息，video：视频消息，file：文件消息，cmd：透传消息| | |type|消息类型；txt:文本消息，img：图片消息，loc：位置消息，audio：语音消息，video：视频消息，file：文件消息，cmd：透传消息| | ||
| 行 485: | 行 485: | ||
| <code php> | <code php> | ||
| - | curl -X POST -H "Authorization:Bearer YWMtxc6K0L1aEeKf9LWFzT9xEAAAAT7MNR_9OcNq-GwPsKwj_TruuxZfFSC2eIQ" -i "https://a1.easemob.com/easemob-demo/testapp/messages" -d '{"target_type":"users","target":["user2","user3"],"msg":{"type":"cmd","action":"action1"},"from":"user1"}}' | + | curl -X POST -H "Authorization:Bearer YWMtxc6K0L1aEeKf9LWFzT9xEAAAAT7MNR_9OcNq-GwPsKwj_TruuxZfFSC2eIQ" -i "https://a1.easemob.com/easemob-demo/testapp/messages" -d '{"target_type":"users","target":["user2","user3"],"msg":{"type":"cmd","action":"action1"},"from":"user1"}' |
| </code> | </code> | ||
| 行 557: | 行 557: | ||
| ^参数^说明^ | ^参数^说明^ | ||
| |target_type|发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息| | |target_type|发送的目标类型；users：给用户发消息，chatgroups：给群发消息，chatrooms：给聊天室发消息| | ||
| - | |target|发送的目标；注意这里需要用数组，即使只有一个用户，也要用数组 ['u1']；给用户发送时数组元素是用户名，给群组发送时，数组元素是groupid| | + | |target|发送的目标；注意这里需要用数组，并且向数组内添加的用户不能超过1000个，即使只有一个用户，也要用数组 ['u1']；给用户发送时数组元素是用户名，给群组发送时，数组元素是groupid| |
| |msg|消息内容| | |msg|消息内容| | ||
| |type|消息类型，不局限与文本消息。任何消息类型都可以加扩展消息；txt:文本消息，img：图片消息，loc：位置消息，audio：语音消息，video：视频消息，file：文件消息| | |type|消息类型，不局限与文本消息。任何消息类型都可以加扩展消息；txt:文本消息，img：图片消息，loc：位置消息，audio：语音消息，video：视频消息，file：文件消息| | ||