# getBlockActionSourceDetail(Object object)
支持从 [消息快捷操作](https://open.feishu.cn/document/ukzMukzMukzM/ugDN1YjL4QTN24CO0UjN) 点击进入应用后，获取应用模块对应业务的详细信息。
**注意事项**：- 小程序调用该接口前，需要确保已经调用 [requestAccess](https://open.feishu.cn/document/uYjL24iN/uUzMuUzMuUzM/requestaccess) ( 如需兼容 飞书V6.9.0 以下版本，可使用 [login](https://open.feishu.cn/document/uYjL24iN/uYzMuYzMuYzM) )
- 最多选择并返回 20 条消息信息
## 支持说明
应用能力 | Android | iOS | PC | 预览效果
---|---|---|---|---
小程序 | **✓** | **✓** | **✓** | 预览
网页应用 | **✓** | **✓** | **✓** | 预览
## 输入
继承[标准对象输入](https://open.feishu.cn/document/uYjL24iN/ukzNy4SO3IjL5cjM)，扩展属性描述：
名称 | 数据类型 | 必填 | 默认值 | 描述
---|---|---|---|---
triggerCode | string | 是 | | 进入应用时，getHostLaunchQuery获取的参数
**示例值**：c-66a6cd5a2340665fc49e74e4e5c49290
**最小长度**：`1` 字符
## 输出
`success`返回对象的扩展属性：
名称 | 数据类型 | 描述
---|---|---
bizType | string | 业务类型
**可选值**：
- `message`
content | object | 查询的message对象
∟
actionTime | number | Action发生的时间戳、单位秒
∟
messages | object[] | message列表，最多可返回 20 条数据。
∟
messageType | string | 消息类型
**可选值**：
- `text`：文本消息
- `image`：图片消息
- `post`：富文本消息
- `media`：视频消息，支持版本[3.47+](https://open.feishu.cn/document/uYjL24iN/uAjMuAjMuAjM/version-compatibility)
- `file`：文件消息，支持版本[3.47+](https://open.feishu.cn/document/uYjL24iN/uAjMuAjMuAjM/version-compatibility)
- `interactive`：[消息卡片](https://open.feishu.cn/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN)消息，支持版本[3.47+](https://open.feishu.cn/document/uYjL24iN/uAjMuAjMuAjM/version-compatibility)
- `unsupport`：暂不支持的消息类型
∟
sender | object | message发送者对象
∟
name | string | message发送者名字，按调用时客户端语言提供
∟
open_id | string | 用户 [open_id](https://open.feishu.cn/document/home/user-identity-introduction/open-id)
∟
createTime | number | message创建的时间戳、单位秒
∟
support | boolean | 是否是支持的消息类型
∟
content | string | 消息内容：json字符串、文本内容
∟
status | boolean | 消息状态是否有效
∟
openChatId | string | 触发操作会话的 [open_chat_id](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description)
**注意事项**：飞书[V3.40.0](https://open.feishu.cn/document/uYjL24iN/uAjMuAjMuAjM/version-compatibility)及以上版本支持
∟
openMessageId | string | 触发操作的消息 [open_message_id](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/intro#ac79c1c2)
**注意事项**：飞书[V3.40.0](https://open.feishu.cn/document/uYjL24iN/uAjMuAjMuAjM/version-compatibility)及以上版本支持
## 示例代码
```js
tt.getHostLaunchQuery({
success(res) {
if (res.launchQuery) {
let json = JSON.parse(res.launchQuery)
if (json && json.__trigger_id__) {
// getHostLaunchQuery获取triggerCode的方法
tt.getBlockActionSourceDetail({
triggerCode:json.__trigger_id__,
success(res) {
console.log(JSON.stringify(res));
},
fail(res) {
console.log(`getBlockActionSourceDetail fail:${JSON.stringify(res)}`);
}
})
}
} else {
console.log(`getHostLaunchQuery fail:${JSON.stringify(res)}`);
}
},
});
```
`success`返回对象示例：
不同消息类型的返回Message参数示例
#### text 文本消息
```json
{
"messageType":"text",
"sender":{
"name":"剑豪",
"open_id":"ou_bbb89d41d088803ef89f1a798121ac39"
},
"createTime":1603175461,
"support":true,
"openChatId": "oc_xxxxx",
"openMessageId": "om_xxxx",
"content":"{\"text\":\"123\"}",
"status":true
}
```
#### post 富文本消息
```json
{
"messageType":"post",
"sender":{
"name":"剑豪",
"open_id":"ou_bbb89d41d088803ef89f1a798121ac39"
},
"createTime":1602911632,
"support":true,
"openChatId":"oc_xxxxx",
"openMessageId":"om_xxxx",
"content":"{\"title\":\"来来来\",\"content\":[{\"attrs\":[{\"tag\":\"at\",\"open_id\":\"ou_bbb89d41d088803ef89f1a798121ac39\",\"text\":\"@剑豪\"},{\"tag\":\"text\",\"text\":\" \"}]},{\"attrs\":[{\"tag\":\"img\",\"url\":\"xxximageUrl\"}]},{\"attrs\":[{\"tag\":\"text\",\"text\":\"光谷六路十五号\"},{\"tag\":\"unknown\",\"text\":\"\"},{\"tag\":\"unknown\",\"text\":\"\"},{\"tag\":\"unknown\",\"text\":\"\"},{\"tag\":\"unknown\",\"text\":\"\"},{\"tag\":\"unknown\",\"text\":\"\"},{\"tag\":\"text\",\"text\":\"啦啦啦啦\"},{\"tag\":\"unknown\",\"text\":\"\"},{\"tag\":\"unknown\",\"text\":\"\"},{\"tag\":\"unknown\",\"text\":\"\"}]}]}",
"status":true
}
```
#### image 图片消息
```json
{
"messageType":"image",
"sender":{
"name":"XXX",
"open_id":"XXXXID"
},
"createTime":1602584487,
"support":true,
"openChatId":"oc_xxxxx",
"openMessageId":"om_xxxx",
"content":"{\"url\":\"https://s3-imfile.feishucdn.com/static-resource/v1/f8836d60-07cb-4fd4-92ce-01e54952f79g~?image_size=72x72&cut_type=&quality=&format=png&sticker_format=.webp\"}",
"status":true
}
```
其中，url 为图片的下载链接，关于**如何通过URL获取图片详情**，参见文末"[其他说明](https://open.feishu.cn/document/getBlockActionSourceDetail#26591811)"
#### media 视频消息
```json
{
"messageType":"media",
"sender":{
"name":"XXX",
"open_id":"XXXXID"
},
"createTime":1602584487,
"support":true,
"openChatId":"oc_xxxxx",
"openMessageId":"om_xxxx",
"content":"{\"file_url\":\"xxx\",\"image_url\":\"xxx\",\"duration\":\"xxx\"}",
"status":true
}
```
file_url 为视频消息中视频文件的下载链接，image_url 为视频预览封面的下载链接，duration 为视频的时长，单位为 ms；下载方式可详见文末[其他说明](https://open.feishu.cn/document/getBlockActionSourceDetail#26591811)。
#### file 文件消息
```json
{
"messageType":"file",
"sender":{
"name":"XXX",
"open_id":"XXXXID"
},
"createTime":1602584487,
"support":true,
"openChatId":"oc_xxxxx",
"openMessageId":"om_xxxx",
"content":"{\"file_url\":\"xxx\"}",
"status":true
}
```
file_url 为文件消息中对应文件的下载链接，下载方式可详见文末[其他说明](https://open.feishu.cn/document/getBlockActionSourceDetail#26591811)。
#### interactive [消息卡片](https://open.feishu.cn/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN)消息
```json
{
"messageType":"interactive",
"sender":{
"name":"XXX",
"open_id":"XXXXID"
},
"createTime":1602584487,
"support":true,
"openChatId":"oc_xxxxx",
"openMessageId":"om_xxxx",
"content":"{\"title\":\"xxx\",\"elements\":[[{\"tag\":\"at\",\"user_id\":\"xxx\",\"user_name\":\"xxx\"},{\"tag\":\"text\",\"text\":\"xxx\"}],[{\"tag\":\"img\",\"image_key\":\"xxx\"},{\"tag\":\"a\",\"href\":\"xxx\",\"text\":\"xxx\"}],...]}",
"status":true
}
```
#### unsupport 暂不支持的消息类型
```json
{
"messageType":"unsupport",
"sender":{
"name":"剑豪",
"open_id":"ou_bbb89d41d088803ef89f1a798121ac39"
},
"createTime":1603357833,
"support":false,
"openChatId": "oc_xxxxx",
"openMessageId": "om_xxxx",
"content":"[该消息类型暂不支持快捷操作]",
"status":true
}
```
## 错误码
`fail`返回对象中会包含[errCode属性](https://open.feishu.cn/document/uYjL24iN/ukzNy4SO3IjL5cjM#a825f4c8)，代表错误码，具体错误码列表参见：
| 错误码 | 错误信息 | 描述 |
| --------- | --------------- | --------- |
|`42301` | `triggerCode is empty` | triggerCode为空 |
|`42302` | `invalid triggerCode` | triggerCode不合法 |
|`42303` | `not login` | 未登录 |
|`42304` | `get block action failed` | 获取message信息失败 |
|`42305` | `service is not valid` | 依赖服务不可用 |
## 其他说明
> 服务台卡片报错42304
暂不支持服务台@匿名用户会固定失败
> 如何以URL获取图片/视频/文件的详情。
**1. 通过接口获取URL**
以图片为例，json结构如下：
```json
{
"url":"https://open.feishu.cn/open-apis/im/v1/images/:image_key"
}
```
**2. 根据获取到的URL下载资源**
- 请求
| 基本 | |
| --------- | --------------- | ------- | ----------- | --------- |
| HTTP URL | 使用以下服务端 API 进行下载：
**下载视频/文件**： [下载文件](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/file/get)
**下载图片**： [下载图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/get)|
| HTTP Method | GET 请求|
- 请求头
| 参数 | 数据类型 | 必填 | 描述 | 实例 |
| --------- | --------------- | ------- | ----------- | --------- |
|`Authorization` | `string` | 是| tenant_access_token；注意内容不要漏了 "Bearer"| Bearer t-394890fdlkfjdajfljajdkf |
备注：请求该 URL 的应用和获取该 URL 的应用必须是同一应用。
**3. Postman实例截图**
