微伴助手OpenAPI

新增素材

POST/open-api/material_library/add

错误码	说明
21301	传递过来的标签id重复或不存在
21307	参数缺失
21308	mtype参数不正确，只能选择（"poster", "pdf", "word", "excel", "ppt"）
调用此接口需购买基础席位。

请求参数

mtype

string

必需

素材类型（可选类型："link"(链接), "poster"(海报), "pdf"(pdf文件), "word"（word文件）, "excel"(excel文件), "ppt"(ppt文件)）

title

string

必需

图文消息的标题或者文件名

thumb_url

string

可选

封面图地址(mtype为"link"时必填)

url

string

图文或者文件url

必需

digest

string

可选

图文消息的摘要，仅有单图文消息才有摘要，多图文此处为空 ("link", )

file_size

string

可选

上传文件大小(mtype为 "poster", "pdf", "word", "excel", "ppt"时必填)

group_id_list

array[string]

素材库分组ID

必需

material_tag_id_list

array[integer]

可选

文案素材标签id列表，可以通过/material_library/tag/list获取标签列表，传入ID，给素材打上相应标签

{
  "mtype": "string",
  "title": "string",
  "thumb_url": "string",
  "url": "string",
  "digest": "string",
  "file_size": "string",
  "group_id_list": [
    "string"
  ],
  "material_tag_id_list": [
    0
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

errcode

integer

可选

状态码，0为正常，非0代表错误。业务错误码下述，全局错误码见全局错误码

errmsg

string

可选

错误信息，成功时为'ok'，错误时会以中文方式显示错误原因

material_library

object

可选

digest

string

可选

图文消息的摘要，仅有单图文消息才有摘要，多图文此处为空

file_id

integer | null

文件id

可选

file_size

string

文件大小

可选

integer

后台id

可选

is_publish

boolean

是否发布

可选

mtype

string

可选

素材类型（可选类型："link", "poster", "pdf", "word", "excel", "ppt"）

publish_status

string

可选

发布状态："first_review": 首次审核 "modify_review": 修改审核 "first_no_review": 首次未审核 "modify_no_review": 修改后未审核 "has_review": 已审核

thumb_url

string

封面图地址

可选

title

string

可选

图文消息的标题或者文件名

url

string

可选

图文页的url，或者，当获取的列表是图片素材列表时，该字段是图片的url,

{
  "errcode": 0,
  "errmsg": "ok",
  "material_library": {
    "digest": "",
    "file_id": null,
    "file_size": "",
    "id": 0,
    "is_publish": false,
    "mtype": "link",
    "publish_status": "first_no_review",
    "thumb_url": "",
    "title": "",
    "url": ""
  }
}

最后修改时间： 1 个月前