1.1. 拉取媒体文件
该接口用于拉取媒体文件
1.1.1. 请求方法
POST api/v1/getFile
1.1.2. 请求参数
参数 | 是否必须 | 说明 |
---|---|---|
corpId | 是 | 企业微信corp_id |
sdkFileId | 是 | 一次调用限制的limit值,不能超过1000. |
indexbuf | 否 | 媒体消息分片拉取,需要填入每次拉取的索引信息。首次不需要填写,后续每次调用只需要将上次调用返回的outindexbuf填入即可。 |
1.1.3. 请求示例
{
"corp_id": "wx***********078",
"sdkFileId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"indexbuf": "123123123123123"
}
1.1.4. 返回数据
属性名 | 类型 | 说明 |
---|---|---|
errcode | 整型 | 0表示成功,错误返回非0错误码,需要参看errmsg。 |
errmsg | 字符串 | 返回信息,如非空为错误原因。 |
outindexbuf | 字符串 | 下次拉取索引信息 |
is_finish | 整型 | 是否拉取完毕,1 完毕 |
media_data | 字节数组 | 文件内容二进制数组 |
1.1.5. 返回示例
{
"errcode": 0,
"errmsg": "ok",
"outindexbuf": "aaaaaaaaaaaaaaabbbbbbbbbbbbbcccccccccccc",
"is_finish": 0,
"media_data": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}