小程序
取消
开发
中文
EN
取消
  • 服务端

    • # 修改剧目基本信息

    调试诊断

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

    接口英文名：submitModifyDramaBasicInfoReq

    该接口用于修改剧目基本信息。请求成功后，需要经过审核，审核通过后，最终才会修改基本信息。审核完成后，会下发通知。

    # 1. 调用方式

    # HTTPS 调用

    POST https://api.weixin.qq.com/wxa/sec/vod/modifydramabasicinfo?access_token=ACCESS_TOKEN

    # 云调用

    • 本接口不支持云调用。

    # 第三方调用

    • 本接口支持第三方平台代商家调用。

    • 该接口所属的权限集 id 为：153

    • 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

    # 2. 请求参数

    # 查询参数 Query String Parameters

    参数名类型必填示例说明
    access_tokenstring是ACCESS_TOKEN接口调用凭证，可使用 access_token、authorizer_access_token

    # 请求体 Request Payload

    参数名类型必填说明
    drama_idnumber是剧目id
    descriptionstring否剧目简介，支持填写200个字符。
    cover_material_idstring否剧目海报临时material_id。
    recommendationsstring否剧目推荐语。
    promotion_poster_material_idstring否推广海报临时material_id。
    alternate_namestring否备用剧名。
    actor_listobject否演员信息。如果需要修改，请填写所有的演员信息。
    qualification_typenumber否剧目资质：1-取得《网络剧片发行许可证》或重点节目备案号；2-未取得《网络剧片发行许可证》或重点节目备案，且制作成本小于30万元 注： 1、 （1）剧目资质=1：需上传“网络剧片发行许可证”或“广电备案系统截图”，平台会在视频播放环节展示备案号水印； （2）剧目资质=2：制作成本在30万以内，需上传《成本配置比例情况报告》。剧目经平台审核后由平台下发备案号（备案号仅适用微信小程序平台）并在视频播放环节展示备案号水印。 2、2024年5月27日前发起提审的剧目可支持修改，且同一剧目仅支持修改一次。
    registration_numberstring否剧目备案号，当qualification_type=1时必填。根据提供的剧目资质证明文件填写对应的网络剧片发行许可证编号或剧目备案号。如：(沪)网剧审字(2023)第001号 或 V123456788888888
    qualification_certificate_material_idstring否剧目资质证明文件，当qualification_type=1时必填。请提供网络剧片发行许可证或广电备案系统截图。查看截图示例
    cost_of_productionnumber否剧目制作成本（单位：万元），当qualification_type=2时必填。请填写“1-29” 的整数（如非整数将截断取整），数值需与《成本配置比例情况报告》中对应剧目制作成本一致。
    cost_commitment_letter_material_idstring否《成本配置比例情况报告》material_id，当qualification_type=2时必填。点击下载新模板，点击下载旧模板（注：2024年5月29日后提审需提供新模板）
    other_material_material_idstring否其他材料material_id，如涉及互动短剧，请上传完整剧情走线示意图。
    producerstring否剧目制作方。apply_for_copyright_protection =1时必填，否则无需填写。
    copyrightobject否版权保护相关。apply_for_copyright_protection =1时必填，否则无需填写 。

    # Body.actor_list Object Payload

    演员信息。如果需要修改，请填写所有的演员信息。

    参数名类型必填说明
    actorobjarray是演员列表

    # Body.copyright Object Payload

    版权保护相关。apply_for_copyright_protection =1时必填，否则无需填写 。

    参数名类型必填说明
    copyright_rolenumber是提审主体身份，1. 剧目制作方; 2. 授权播出方或版权方。 number 必填 number 选填。

    2024年12月30日00:00起，apply_for_copyright_protection=1时必填。

    apply_for_copyright_protectionnumber是是否申请版权保护，0. 不申请; 1. 申请。不申请时必须上传权利声明/播放授权材料。
    copyright_verificationstring否版权验证方式：1. 基于版权证明材料; 2. 基于版权授权关系。 （2024年12月30日00:00起，apply_for_copyright_protection=1时必填。）
    proof_of_productionarray否剧目制作证明材料临时 material_id，最多支持上传 4 个。（apply_for_copyright_protection=1时必填。

    2024年12月30日00:00起，apply_for_copyright_protection=1且copyright_verification=2时无需填写。 ）

    purchase_or_broadcast_authorization_certificatearray否版权采买/播出授权证明材料临时 material_id，最多支持上传 4 个。 提审身份非剧目制作方时请上传： 1. 版权采买证明材料 (提审身份为版权方/授权播出方时需提供)； 2. 播出授权材料 (提审身份为授权播出方时需提供) （apply_for_copyright_protection=1时选填。）

    # Body.actor_list.actor(Array) Object Payload

    演员列表

    参数名类型必填说明
    namestring是演员姓名，格式要求：可填写30个字符，支持输入中文、英文和·
    photo_material_idstring是演员照片临时material_id
    rolestring是饰演角色，格式要求：可填写30个字符，支持输入中文、英文及，。；”“？、—《》！（）-·
    profilestring是演员简介，填写内容可参考：生日、星座、籍贯、身高、毕业院校、历史/代表作品、获奖信息、成就等(以上要素需至少满足3项或涵盖任一要素且不少于20字）。 格式要求：可填写100个字符，支持输入中文、英文、阿拉伯数字及，。：；“”？、—《》！（）-·

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型示例说明
    errcodenumber-错误码
    errmsgstringok错误信息

    # 4. 注意事项

    1. 剧目必须已经审核通过。
    2. 审核完成后会发送事件通知
    3. 本接口中使用的临时图片material_id可通过新增临时素材接口上传得到，对应临时素材接口中的media_id，本文档中为避免与剧集的media_id混淆，称其为material_id。

    # 5. 代码示例

    请求示例

    {
    "drama_id": 10001,
    "description": "新剧目简介",
    "cover_material_id": "新剧目海报临时material_id",
    "recommendations": "新剧目推荐语",
    "promotion_poster_material_id": "新推广海报临时material_id",
    "alternate_name": "备用剧名",
    "actor_list": {
        "actor": [{
            "name": "演员1",
            "photo_material_id": "xxxxxxxx",
            "role": "角色1",
            "profile": "简介"
        }, {
            "name": "演员2",
            "photo_material_id": "xxxxxxxx",
            "role": "角色2",
            "profile": "简介"
        }]
    },
     "qualification_type": 1,
     "qualification_certificate_material_id": "xxxxxxxx",
     "registration_number":"V123456788888888",
     "other_material_material_id":"新其他材料临时material_id"
}

    返回示例

    {
    "errcode": 0,
    "errmsg": "ok"
}

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

    错误码错误描述
    -2初始化未完成，请稍后再试
    -1系统错误
    43002HTTP请求必须使用POST方法
    44002POST内容为空
    47001输入格式错误
    47003参数不符合要求
    10090001视频类型不支持
    10090002图片类型不支持
    10090003图片URL无效
    10090005resource_type无效
    10090038被授权账号没有【文娱-微短剧】类目
    10090039已经被解除授权
    10090040剧集已经被占用
    10090041剧目名称不符合规范
    10090042剧集名称不符合规范
    10090043不存在授权关系
    10093011操作失败
    10093014参数错误（包括参数格式、类型等错误）
    10093023操作过于频繁
    10093030资源不存在

    # 7. 适用范围

    本接口暂未明确可调用账号类型，或在业务中根据调用传参自行确定是否可调用，请已实际调用情况为准。