新增素材 - 微伴助手OpenAPI

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

请求参数

Query 参数

access_token

string

调用接口凭证

必需

默认值:

Body 参数application/json

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
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

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": ""
  }
}

🟢200正常返回