技术文档

# 图文添加/更新


开发之前请创建腾讯数据接入数据源 （dataSourceId），可将 dataSourceId 理解为数据的集合。创建一个数据仓库后，所有接口传输数据时都可重复使用。


# 请求地址

域名/data-api/v1/article/add


# 请求方法

POST


# 请求参数

参数名 样例 描述
app_id abc 分配的app_id
nonce 61794670f155b 随机字符串
sign sha256 签名算法
timestamp 1569232087 请求时间戳（秒级）
signature aee30792812d7b09ba7d3aa67c24e16c6a7ea81282ac728ad5966dd1b3eef6d5 签名结果

# 请求体类型

application/json


# 请求体参数

名称
类型
必填
描述
dataSourceIdstringY数据源id（create方法返回的data.dataSource.id）
articlesarrayY图文列表，数组最大长度 50
external_article_idstringY外部图文ID，字段长度最小 1 字节，长度最大 100 字节
titlestringY图文标题
typeintegerY图文类型，1：推广内容；2：长文笔记；3：短文笔记
authorstringY作者名称
seller_idstring种草号ID
producer_idstringMCNID
originalintegerY是否原创，1：原创；0：非原创
publish_timestringY发布时间，时间戳，毫秒
publish_statusintegerY发布状态，0：上线；1：下线
media_infoobjectY图文图片及视频信息，最大长度 10
primary_imgsobjectY主图图片信息列表 数组最大长度 10
img_urlstringY主图地址；字段长度最小 1 字节，长度最大 2048 字节
imgsarray轮播图信息列表 数组最大长度 10
img_urlstring轮播图地址；图片320*320以上，10张，正方形图片可正常打开 字段长度最小 1 字节，长度最大 2048 字节
detail_imgsarray详情页图片信息列表 数组最大长度 50
img_urlstring详情图片地址，50张，图片可正常打开，字段长度最小 1 字节，长度最大 2048 字节
rich_text_urlstring富文本地址，最大长度50，url可正常打开，字段长度最小 1 字节，长度最大 2048 字节
videosarray视频信息，数组最大长度 10
video_urlstring视频地址；字段长度最小 1 字节，长度最大 2048 字节
img_urlstring视频封面图片地址，1张，字段长度最小 1 字节，长度最大 2048 字节
category_infoarrayY类目信息，数组
category_typeintegerY类目类型，1：前台类目；2：后台类目
category_level_1_idstringY一级类目id
category_level_1_namestringY一级类目名称
category_level_2_idstring二级类目id
category_level_2_namestring二级类目名称
category_level_3_idstring三级类目id
category_level_3_namestring三级类目名称
category_level_4_idstring四级类目id
category_level_4_namestring四级类目名称
target_urlobjectY图文详情页信息
url_miniprogramstringC微信小程序落地页 url，当落地页为微信小程序时必填 字段长度最小 1 字节，长度最大 100 字节
miniprogram_appidstringC微信小程序 appid，当落地页为微信小程序时必填 字段长度最小 1 字节，长度最大 100 字节
miniprogram_usernamestringC小程序原始ID，登录小程序管理后台-设置-基本设置-帐号信息中，gh_xx，当落地页为微信小程序时必填字段长度最小 1 字节，长度最大 100 字节
url_miniprogram_qqstringCqq小程序落地页 url，当落地页为QQ小程序时必填 字段长度最小 1 字节，长度最大 100 字节
miniprogram_appid_qqstringCqq小程序 appid，当落地页为QQ小程序时必填 字段长度最小 1 字节，长度最大 100 字节
url_h5stringCh5落地页url 字段长度最小 1 字节，长度最大 100 字节
productobjectY图文关联的商品信息
sku_idsstring[]图文关联的sku列表，数组，长度最大 2048 字节
spu_idsstring[]图文关联的spu列表，数组，长度最大 2048 字节
feedbackobject图文反馈信息
thumbs_up_numinteger图文点赞次数
collect_numinteger图文收藏次数
tag_infoobject图文的标签信息 数组最大长度 10
custom_tagarray图文的标签信息 数组最大长度 50
tag_namestring标签名称，长度最大 2048 字节
tag_valuestring[]标签值，数组，长度最大 2048 字节
is_deletedinteger商家标记图文已删除，0：未删除；1：已删除，为空默认为 0

# 请求体示例

{
    "dataSourceId": "12",
    "articles": [
        {
            "external_article_id": "", //外部图文ID
            "title": "", //图文标题
            "type": "", //图文类型，1：推广内容；2：长文笔记；3：短文笔记
            "author": "", //作者名称
            "seller_id": "", //种草号ID
            "producer_id": "", //MCNID
            "original": "1", //是否原创，1：原创；0：非原创
            "publish_time": "", //发布时间
            "publish_status": 1, //发布状态，0：上线；1：下线
            "media_info": {
                "primary_imgs": {
                    "img_url": "http://abcd.com/1.jpg"
                }, //封面图
                "imgs": [
                    {
                        "img_url": "http://abcd.com/1.jpg"
                    },
                    {
                        "img_url": "http://abcd.com/2.jpg"
                    }
                ], //轮播图
                "detail_imgs": [
                    {
                        "img_url": "http://abcd.com/1.jpg"
                    },
                    {
                        "img_url": "http://abcd.com/2.jpg"
                    }
                ], //内容图
                "videos": [
                    {
                        "img_url": "http://abcd.com/1.jpg",
                        "video_url": "http://abcd.com/vedio1.mp4"
                    },
                    {
                        "img_url": "http://abcd.com/2.jpg",
                        "video_url": "http://abcd.com/vedio2.mp4"
                    }
                ] //视频
            },
            "category_info": [
                {
                    "category_type": 2,
                    "category_level_1_id": "1",
                    "category_level_1_name": "一级类目名称",
                    "category_level_2_id": "2",
                    "category_level_2_name": "二级类目名称",
                    "category_level_3_id": "3",
                    "category_level_3_name": "三级类目名称"
                }
            ], //内容分类名称
            "target_url": {
                "url_miniprogram": "",
                "miniprogram_appid": "",
                "url_miniprogram_qq": "",
                "miniprogram_appid_qq": "",
                "url_h5": ""
            },
            "product": {
                "sku_ids": [
                    "311132",
                    "234234"
                ],
                "spu_ids": [
                    "311132",
                    "234234"
                ]
            },
            "feedback": {
                "thumbs_up_num": 3343, //点赞次数
                "collect_num": 2432, //收藏次数
            },
            "tag_info": {
                "custom_tag": [
                    {
                        "tag_name": "",
                        "tag_value": [
                            ""
                        ]
                    }
                ]
            },
            "is_deleted": 0
        }
    ]
}

# 应答体结构

名称
类型
描述
retcodeinteger返回码
errmsgstring错误信息
datajson object响应内容

# 应答示例

{
 "retcode": 0,
 "errmsg": "",
 "data": {}
}