云真机

API接口文档


获取素材列表

<h5>简要描述</h5> <ul> <li>在企微宝云端版收录的素材列表,可用于发送消息。使用举例:1、在web端素材库打开手机端上传开关;2、通过手机端登录的企微号把小程序发给企微号自身,该小程序会被自动收录到素材库;3、通过此处素材列表可请求到该小程序的具体参数;4、再参照文档“&lt;a href='<a href="https://www.showdoc.com.cn/qybopen/7988142920476637'&gt;发送消息/公告&lt;/a&gt;”可将该小程序发给其他客户或客户群">https://www.showdoc.com.cn/qybopen/7988142920476637'&gt;发送消息/公告&lt;/a&gt;”可将该小程序发给其他客户或客户群</a>。</li> </ul> <h5>请求URL</h5> <ul> <li><code>https://oapi-yzj.miaokol.com/index/mediaList</code></li> </ul> <h5>请求方式</h5> <ul> <li>GET </li> </ul> <h5>请求参数</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">app_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>APP ID</td> </tr> <tr> <td style="text-align: left;">access_token</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>Access Token</td> </tr> <tr> <td style="text-align: left;">page</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>页码,默认1</td> </tr> <tr> <td style="text-align: left;">page_size</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>每页条数,默认10,最大100</td> </tr> <tr> <td style="text-align: left;">search</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>关键词搜索标题或内容</td> </tr> <tr> <td style="text-align: left;">is_personal</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>是否个人素材:0否;1是。默认-1表示全部素材(包含企业和个人收录的全部素材)</td> </tr> <tr> <td style="text-align: left;">sub_user_id</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>仅当is_personal传1时该参数有效,传0表示获取主账号收录的个人素材;传其他子账号ID表示获取其他子账号收录的个人素材</td> </tr> <tr> <td style="text-align: left;">type</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>素材类型(文字:text、图片:picture、视频:video、文件:file、链接:link、小程序:program、视频号:channel、语音:voice)</td> </tr> <tr> <td style="text-align: left;">id</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>素材ID,可使用该字段只请求单条素材</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code>GET /index/mediaList?app_id=xxx&amp;amp;access_token=xxxx&amp;amp;page=1&amp;amp;page_size=10 HTTP/1.1 Host:oapi-yzj.miaokol.com content-type: application/x-www-form-urlencoded </code></pre> <h5>响应示例</h5> <pre><code>HTTP/1.1 200 OK {     &amp;quot;data&amp;quot;:[         {     &amp;quot;id&amp;quot;:235,     &amp;quot;user_id&amp;quot;:21,     &amp;quot;sub_user_id&amp;quot;:0,     &amp;quot;corp_id&amp;quot;:0,     &amp;quot;title&amp;quot;:&amp;quot;我的测试素材啊!&amp;quot;,     &amp;quot;items&amp;quot;:[         {             &amp;quot;id&amp;quot;:&amp;quot;16408312888405230&amp;quot;,             &amp;quot;msg_type&amp;quot;:&amp;quot;text&amp;quot;,             &amp;quot;content&amp;quot;:{                 &amp;quot;items&amp;quot;:[                     {                         &amp;quot;type&amp;quot;:&amp;quot;text&amp;quot;,                         &amp;quot;text&amp;quot;:&amp;quot;测试!&amp;quot;                     }                 ]             }         },         {             &amp;quot;id&amp;quot;:&amp;quot;16408313975526876&amp;quot;,             &amp;quot;msg_type&amp;quot;:&amp;quot;picture&amp;quot;,             &amp;quot;content&amp;quot;:{                 &amp;quot;url&amp;quot;:&amp;quot;https:\/\/qiyunbao.oss-cn-hangzhou.aliyuncs.com\/u\/21\/20211230\/85f6bd58f1cb65366ba2d09ccfde72b2.jfif&amp;quot;             }         },         {             &amp;quot;id&amp;quot;:&amp;quot;16408314020915051&amp;quot;,             &amp;quot;msg_type&amp;quot;:&amp;quot;file&amp;quot;,             &amp;quot;content&amp;quot;:{                 &amp;quot;url&amp;quot;:&amp;quot;https:\/\/qiyunbao.oss-cn-hangzhou.aliyuncs.com\/u\/21\/20211230\/eff24e17030353a56167b9f9137c2638.html&amp;quot;,                 &amp;quot;title&amp;quot;:&amp;quot;话术库 - 企云宝.html&amp;quot;,                 &amp;quot;name&amp;quot;:&amp;quot;话术库 - 企云宝.html&amp;quot;,                 &amp;quot;size&amp;quot;:&amp;quot;150.38 kB&amp;quot;             }         },         {             &amp;quot;id&amp;quot;:&amp;quot;16408314801042533&amp;quot;,             &amp;quot;msg_type&amp;quot;:&amp;quot;link&amp;quot;,             &amp;quot;content&amp;quot;:{                 &amp;quot;url&amp;quot;:&amp;quot;https:\/\/www.jd.com&amp;quot;,                 &amp;quot;title&amp;quot;:&amp;quot;这是应该测试京东的连接&amp;quot;,                 &amp;quot;cover&amp;quot;:&amp;quot;https:\/\/qiyunbao.oss-cn-hangzhou.aliyuncs.com\/u\/21\/20211230\/85f6bd58f1cb65366ba2d09ccfde72b2.jfif&amp;quot;,                 &amp;quot;desc&amp;quot;:&amp;quot;打开京东open brower  www.jd.com  gc!&amp;quot;             }         },         {             &amp;quot;client_id&amp;quot;:&amp;quot;CAMQm+SfiwYYt+Pgi5qAgAMgjpb6swc=&amp;quot;,             &amp;quot;content&amp;quot;:{                 &amp;quot;appid&amp;quot;:&amp;quot;wxece3a9a4c82f58c9&amp;quot;,                 &amp;quot;cover&amp;quot;:&amp;quot;\/\/qiyunbao.oss-cn-hangzhou.aliyuncs.com\/media\/public\/wechatdata\/21\/1688856864240055\/pic\/880bf000a850eabeccbb5c9c06b50253.jpg&amp;quot;,                 &amp;quot;name&amp;quot;:&amp;quot;饿了么 l 外卖美食超市买菜水果&amp;quot;,                 &amp;quot;org_content&amp;quot;:{                     &amp;quot;author&amp;quot;:&amp;quot;gh_6506303a12bb@app&amp;quot;,                     &amp;quot;headimgheight&amp;quot;:416,                     &amp;quot;headimgkey&amp;quot;:&amp;quot;d80e8a6663cc4dad8da0a72f6e4b6582&amp;quot;,                     &amp;quot;headimgsize&amp;quot;:61424,                     &amp;quot;headimgwidth&amp;quot;:520,                     &amp;quot;md5&amp;quot;:&amp;quot;880bf000a850eabeccbb5c9c06b50253&amp;quot;,                     &amp;quot;page&amp;quot;:&amp;quot;pages\/index\/index.html?qrcode=weixin-share&amp;quot;,                     &amp;quot;wxurl&amp;quot;:&amp;quot;3069020102046230600201000204a17831b702030f4df90204d0136071020461640327042462393366336636662d343035642d343637332d626131642d636636393333653366646338020100020300f0000410880bf000a850eabeccbb5c9c06b502530201010201000400&amp;quot;                 },                 &amp;quot;title&amp;quot;:&amp;quot;饿了么小程序,红包天天领&amp;quot;,                 &amp;quot;weapp_iconurl&amp;quot;:&amp;quot;http:\/\/mmbiz.qpic.cn\/sz_mmbiz_png\/uLzlOotx1RIyCXe9C6fuk5GUUnzFUTRQmIMcL8lWftU48U9BiaN1Y3kScbSibBaxVnp5ULCiahpic3PWlMjz2QpjWA\/640?wx_fmt=png&amp;amp;wxfrom=200&amp;quot;             },             &amp;quot;msg_hash&amp;quot;:&amp;quot;8efc9b74eba76c437c2b5d2596c4f8e5ef0c1a12&amp;quot;,             &amp;quot;msg_time&amp;quot;:1634202139000,             &amp;quot;msg_type&amp;quot;:&amp;quot;program&amp;quot;,             &amp;quot;wx_msgid&amp;quot;:&amp;quot;0&amp;quot;,             &amp;quot;wx_svrid&amp;quot;:&amp;quot;1017434&amp;quot;,             &amp;quot;user_id&amp;quot;:21,             &amp;quot;sub_user_id&amp;quot;:0,             &amp;quot;corp_id&amp;quot;:2,             &amp;quot;svrid&amp;quot;:&amp;quot;1688856864240055,1688856864240055,8efc9b74eba76c437c2b5d2596c4f8e5ef0c1a12&amp;quot;,             &amp;quot;chat_wxid&amp;quot;:&amp;quot;1688856864240055&amp;quot;,             &amp;quot;chat_type&amp;quot;:1,             &amp;quot;bucket&amp;quot;:&amp;quot;qiyunbao&amp;quot;,             &amp;quot;id&amp;quot;:&amp;quot;16408314954187701&amp;quot;         },         {             &amp;quot;client_id&amp;quot;:&amp;quot;CAMQjOOfiwYYt+Pgi5qAgAMgpur9xAE=&amp;quot;,             &amp;quot;content&amp;quot;:{                 &amp;quot;avatar&amp;quot;:&amp;quot;http:\/\/wx.qlogo.cn\/finderhead\/iaRlzG8zy7Bu2kAlKuibj9nXqT6RcNavr0JOoqKHKJhyiaguVaOXpDzcQ\/132&amp;quot;,                 &amp;quot;cover&amp;quot;:&amp;quot;\/\/qiyunbao.oss-cn-hangzhou.aliyuncs.com\/media\/public\/wechatdata\/21\/1688856864240055\/pic\/633ed10acf15b0214ec87f0adb48f6fb.jpg&amp;quot;,                 &amp;quot;desc&amp;quot;:&amp;quot;努力才是女孩子们的标配!@宫园薰漫剪 #同好集结##励志##治愈##热门##动漫#&amp;quot;,                 &amp;quot;org_content&amp;quot;:{                     &amp;quot;key&amp;quot;:&amp;quot;CAEoAaoGaQpnZXhwb3J0L1V6RmZBZ3RnZWtJRUFRQUFBQUFBdm1zNVRxOUNfd0FBQUFzdFF5NnViYUxYNEtIV3ZMRVpnQlBFd29NQVZpY3ZPYm4tek5QZ01JRGEyMzZ3TUdSc1hrdGhYZGlVZGFZMA==&amp;quot;,                     &amp;quot;wxurl&amp;quot;:&amp;quot;http:\/\/wxapp.tc.qq.com\/251\/20350\/stodownload?encfilekey=XGocBFxVWK5dcyOOqpEU47RpBHQIvlhn9TIjoywiaVcH1h0yKAprTcfz6lRaVXHwFPRhhbBzgNgWnZkHwVVCJ3BibBPrRxAsaXCPuyqlWSkjOJiaGMDs9GibSRjBA30ibg3pxKk2YicWXiabTpOFaM5zCEj4TKJEvicJVwhiaiaoz3DlukYvwOFzqNWPeiaeQ&amp;amp;adaptivelytrans=0&amp;amp;bizid=1023&amp;amp;dotrans=0&amp;amp;hy=SH&amp;amp;idx=1&amp;amp;m=633ed10acf15b0214ec87f0adb48f6fb&amp;amp;token=x5Y29zUxcibBVldHPqdg3yicmNmicMgHCASrY3NqzqZbiccbsyic5BzDy4vpKP6q6aILRejINmsEpnkg&amp;amp;finder_expire_time=1634806757&amp;amp;finder_eid=export%2FUzFfAgtgekIEAQAAAAAAvms5Tq9C_wAAAAstQy6ubaLX4KHWvLEZgBPEwoMAVicvObn-zNPgMIDa236wMGRsXkthXdiUdaY0&amp;quot;                 },                 &amp;quot;title&amp;quot;:&amp;quot;宫园薰漫剪&amp;quot;,                 &amp;quot;url&amp;quot;:&amp;quot;https:\/\/channels.weixin.qq.com\/web\/pages\/feed?eid=export%2FUzFfAgtgekIEAQAAAAAAvms5Tq9C_wAAAAstQy6ubaLX4KHWvLEZgBPEwoMAVicvObn-zNPgMIDa236wMGRsXkthXdiUdaY0&amp;quot;             },             &amp;quot;msg_hash&amp;quot;:&amp;quot;2c6983205fa4ddd6d1de86eff7a34e030b5725f0&amp;quot;,             &amp;quot;msg_time&amp;quot;:1634201996000,             &amp;quot;msg_type&amp;quot;:&amp;quot;channel&amp;quot;,             &amp;quot;wx_msgid&amp;quot;:&amp;quot;0&amp;quot;,             &amp;quot;wx_svrid&amp;quot;:&amp;quot;1017432&amp;quot;,             &amp;quot;user_id&amp;quot;:21,             &amp;quot;sub_user_id&amp;quot;:0,             &amp;quot;corp_id&amp;quot;:2,             &amp;quot;svrid&amp;quot;:&amp;quot;1688856864240055,1688856864240055,2c6983205fa4ddd6d1de86eff7a34e030b5725f0&amp;quot;,             &amp;quot;chat_wxid&amp;quot;:&amp;quot;1688856864240055&amp;quot;,             &amp;quot;chat_type&amp;quot;:1,             &amp;quot;bucket&amp;quot;:&amp;quot;qiyunbao&amp;quot;,             &amp;quot;id&amp;quot;:&amp;quot;16408315051352464&amp;quot;         }     ],     &amp;quot;types&amp;quot;:[         &amp;quot;text&amp;quot;,         &amp;quot;picture&amp;quot;,         &amp;quot;file&amp;quot;,         &amp;quot;link&amp;quot;,         &amp;quot;program&amp;quot;,         &amp;quot;channel&amp;quot;     ],     &amp;quot;type_info&amp;quot;:{         &amp;quot;text&amp;quot;:1,         &amp;quot;picture&amp;quot;:1,         &amp;quot;file&amp;quot;:1,         &amp;quot;link&amp;quot;:1,         &amp;quot;program&amp;quot;:1,         &amp;quot;channel&amp;quot;:1     },     &amp;quot;extra&amp;quot;:null,     &amp;quot;ctime&amp;quot;:1640831520,     &amp;quot;utime&amp;quot;:1640831545,     &amp;quot;source_type&amp;quot;:1,     &amp;quot;is_personal&amp;quot;:0,     &amp;quot;tags&amp;quot;:[         {             &amp;quot;id&amp;quot;:9964,             &amp;quot;name&amp;quot;:&amp;quot;企云宝&amp;quot;         }     ] }     ],     &amp;quot;pager&amp;quot;:{         &amp;quot;page&amp;quot;:1,         &amp;quot;perPage&amp;quot;:10,         &amp;quot;numRecords&amp;quot;:1,         &amp;quot;numPages&amp;quot;:1,         &amp;quot;firstRecord&amp;quot;:0,         &amp;quot;lastRecord&amp;quot;:0     },     &amp;quot;msg_type_map&amp;quot;:{         &amp;quot;text&amp;quot;:&amp;quot;文本&amp;quot;,         &amp;quot;picture&amp;quot;:&amp;quot;图片&amp;quot;,         &amp;quot;voice&amp;quot;:&amp;quot;音频&amp;quot;,         &amp;quot;link&amp;quot;:&amp;quot;链接&amp;quot;,         &amp;quot;video&amp;quot;:&amp;quot;视频&amp;quot;,         &amp;quot;file&amp;quot;:&amp;quot;文件&amp;quot;,         &amp;quot;program&amp;quot;:&amp;quot;小程序&amp;quot;,         &amp;quot;card&amp;quot;:&amp;quot;名片&amp;quot;,         &amp;quot;system&amp;quot;:&amp;quot;系统消息&amp;quot;,         &amp;quot;channel&amp;quot;:&amp;quot;视频号&amp;quot;,         &amp;quot;announcement&amp;quot;:&amp;quot;公告&amp;quot;,         &amp;quot;qrcode&amp;quot;:&amp;quot;二维码&amp;quot;     },     &amp;quot;errcode&amp;quot;:0 } </code></pre> <h5>响应说明</h5> <ul> <li>数组项格式说明如下</li> </ul> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">object []</td> <td>数据项</td> </tr> <tr> <td style="text-align: left;">data[0].id</td> <td style="text-align: left;">int</td> <td>素材ID</td> </tr> <tr> <td style="text-align: left;">data[0].title</td> <td style="text-align: left;">string</td> <td>素材标题</td> </tr> <tr> <td style="text-align: left;">data[0].items</td> <td style="text-align: left;">object[]</td> <td>素材中包含的消息列表,结构及字段详见说明-&lt;a href=&quot;<a href="https://www.showdoc.com.cn/qybopen/7990161805486320&quot;&gt;聊天消息&lt;/a&gt">https://www.showdoc.com.cn/qybopen/7990161805486320&quot;&gt;聊天消息&lt;/a&gt</a>;</td> </tr> <tr> <td style="text-align: left;">data[0].types</td> <td style="text-align: left;">array</td> <td>素材中包含的消息类型(文字:text、图片:picture、视频:video、文件:file、链接:link、小程序:program、视频号:channel、语音:voice)</td> </tr> <tr> <td style="text-align: left;">data[0].type_info</td> <td style="text-align: left;">object</td> <td>素材中各种消息类型的数量</td> </tr> <tr> <td style="text-align: left;">data[0].source_type</td> <td style="text-align: left;">int</td> <td>创建来源(1:云端创建;2:手机端;3:客户端;4:云端聊天)</td> </tr> <tr> <td style="text-align: left;">data[0].tags</td> <td style="text-align: left;">object []</td> <td>素材中各种消息类型的数量</td> </tr> <tr> <td style="text-align: left;">pager</td> <td style="text-align: left;">object</td> <td>分页信息,总数:pager.numRecords</td> </tr> <tr> <td style="text-align: left;">msg_type_map</td> <td style="text-align: left;">object</td> <td>消息类型映射关系</td> </tr> </tbody> </table>

页面列表

ITEM_HTML