创建素材

POST

https://aa-hub.ddregion.com/api/v1/material/create

功能说明：

通过本接口可以创建用于群发的素材

请求参数

Query 参数

token

string

必需

Body 参数application/json

materialGroupId

string

素材组ID

必需

name

string

素材名称

必需

scope

string

素材类型

必需

userId

string

个人素材所属的userId,

可选

当scope为User时，userId必传

type

enum<string>

素材类型

必需

"Text", "Image", "Link", "File", "MiniProgram", "Video", "Emoticon", "Voice"

枚举值:

TextImageLinkFileVideoVoiceEmoticonMiniProgram

text

object

文本素材,

必需

当前type为"Text"， text必传

text

string

必需

image

object

图片素材,

必需

当type为"Image", images必传

url

string

必需

name

string

必需

size

number

必需

link

object

网页素材,

必需

当type为"Link" , link必传

url

string

必需

title

string

必需

description

string

必需

imageUrl

string

必需

file

object

文件素材,

必需

当type为"File", file必传

name

string

必需

url

string

必需

size

string

必需

video

object

视频素材,

必需

当type为"Video", video必传（目前只支持mp4）

url

string

必需

thumbUrl

string

必需

title

string

必需

voice

object

语音素材,

必需

当type为"Voice", voice必传

voiceUrl

string

必需

duration

number

必需

emoticon

object

表情素材，

必需

当type为 "Emoticon", emoticon必传

imageUrl

string

必需

miniProgram

object

小程序素材,

必需

当type为"MiniProgram"， miniProgram必传

appid

string

必需

description

string

必需

pagePath

string

必需

thumbUrl

string

必需

title

string

必需

username

string

必需

iconUrl

string

必需

示例

{
    "materialGroupId": "string",
    "name": "string",
    "scope": "string",
    "userId": "string",
    "type": "Text",
    "text": {
        "text": "string"
    },
    "image": {
        "url": "string",
        "name": "string",
        "size": 0
    },
    "link": {
        "url": "string",
        "title": "string",
        "description": "string",
        "imageUrl": "string"
    },
    "file": {
        "name": "string",
        "url": "string",
        "size": "string"
    },
    "video": {
        "url": "string",
        "thumbUrl": "string",
        "title": "string"
    },
    "voice": {
        "voiceUrl": "string",
        "duration": 0
    },
    "emoticon": {
        "imageUrl": "string"
    },
    "miniProgram": {
        "appid": "string",
        "description": "string",
        "pagePath": "string",
        "thumbUrl": "string",
        "title": "string",
        "username": "string",
        "iconUrl": "string"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://aa-hub.ddregion.com/api/v1/material/create?token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "materialGroupId": "string",
    "name": "string",
    "scope": "string",
    "userId": "string",
    "type": "Text",
    "text": {
        "text": "string"
    },
    "image": {
        "url": "string",
        "name": "string",
        "size": 0
    },
    "link": {
        "url": "string",
        "title": "string",
        "description": "string",
        "imageUrl": "string"
    },
    "file": {
        "name": "string",
        "url": "string",
        "size": "string"
    },
    "video": {
        "url": "string",
        "thumbUrl": "string",
        "title": "string"
    },
    "voice": {
        "voiceUrl": "string",
        "duration": 0
    },
    "emoticon": {
        "imageUrl": "string"
    },
    "miniProgram": {
        "appid": "string",
        "description": "string",
        "pagePath": "string",
        "thumbUrl": "string",
        "title": "string",
        "username": "string",
        "iconUrl": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

data

object

必需

string

素材id,

必需

name

string

素材名

必需

scope

string

素材可见范围

必需

Org为企业素材，User为个人素材

userId

string

当scope为User，素材所属的userId

必需

type

string

素材类型

必需

image

object

图片素材

必需

（以图片素材为例）

示例

{
    "errcode": 0,
    "errmsg": "string",
    "data": {
        "id": "string",
        "name": "string",
        "scope": "string",
        "userId": "string",
        "type": "string",
        "image": {
            "url": "string",
            "name": "string"
        }
    }
}

修改于 2025-05-20 03:06:00

获取素材列表

修改素材