多媒体

上传

当第三方使用开放接口创建内容时,如果内容中存在非公网多媒体资源时(如图片、音频等),创建后可能会展示异常。

针对这个情况,需要开发者在创建内容前,把图片和音频等资源通过此接口上传并把返回的地址替换原资源地址。

接口调用说明:

POST https://lxapi.lexiangla.com/cgi-bin/v1/assets

参数说明:

参数 是否必须 说明
type image 表示图片,audio 表示音频
file 需要上传的文件

支持的图片后缀:jpg、jpeg、png、gif

支持的音频后缀:mp3、wav、ogg

单次上传的多媒体资源会限制大小,若超出限制会导致上传失败

SDK封装方法使用示例:

$Lxapi = new \Lexiangla\Openapi\Api(AppKey, AppSecret);
$response = $Lxapi->postAsset(StaffID, 'image', fopen('./test.png', 'r'));

返回说明:

200 OK 状态码
{
    "url": "https://lexiangla.com/assets/ec584a005e6411e89283f5bb3d7c998b"
}

下载

当获取到平台内富文本内容想用于非腾讯乐享平台展示时,内容中若带有图片或音频资源会展示异常。

针对这个情况,需要开发者在获取到富文本内容后,把图片和音频资源通过此接口获取到资源下载链接,把资源存放于开发者自己的服务上,并把新的图片地址替换原资源地址。

注意,通过此接口获取的资源下载链接是带有临时签名的,此签名有效期仅3分钟,请在有效期内下载资源并自行存储。切勿直接使用该地址用于展示。

接口调用说明:

GET https://lxapi.lexiangla.com/cgi-bin/v1/assets/{asset_id}

参数说明:

参数 是否必须 说明
asset_id 如上传接口返回的 https://lexiangla.com/assets/XXX,XXX 即为 asset_id

SDK封装方法使用示例:

$Lxapi = new \Lexiangla\Openapi\Api(AppKey, AppSecret);
$response = $Lxapi->get('assets/ec584a005e6411e89283f5bb3d7c998b');

返回说明:

200 OK 状态码
{
    "url": "https://file.lexiangla.com/company_xxx/assets/2018/10/9729a0d4-d73f-11e8-81ab-8320ef7a9281.png?sign=yfVBfVPbfFoqHWIYlqrV+M8A9+lhPTEwMDI5MTYyJms9QUtJRE4yMmgydDZqV0pscEtMYWdsVVRSaWx6czFycjZvYWZ2JmU9MTU0MDM2MzQxMCZ0PTE1NDAzNjMyMzAmcj01MDAzMTk4NjQmZj0vY29tcGFueV8xYzFkNjY1YWY3MGUxMWU1OGEwMTA4MDAyN2M5MzgyNC9hc3NldHMvMjAxOC8xMC85NzI5YTBkNC1kNzNmLTExZTgtODFhYi04MzIwZWY3YTkyODEucG5nJmI9bGV4aWFuZzR0ZXN0LTEwMDI5MTYy"
}