dingtalk.oapi.serviceaccount.update (服务号更新)

更新服务号

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
name String 可选 钉三多
  • 最大长度:30
  • 服务号名称
    avatar_media_id String 可选 @lALPBbCc1XuaP_rNAljNAlg 头像图片mediaId
    brief String 可选 互动服务窗
  • 最大长度:60
  • 机器人管理列表中的简介,最多60个字符
    desc String 可选 我是钉三多
  • 最大长度:200
  • 机器人主页中的服务号功能简介,最多200个字符
    preview_media_id String 可选 @lALPBbCc1XuaP_rNAljNAlg 机器人主页中,消息预览图片的mediaId
    unionid String 必须 vfdiPCiSeSXdoiE 服务号的unionid
    status String 可选 0 normal-正常,disabled-删除

    响应参数

    名称 类型 示例值 描述
    errmsg String ok 错误信息
    errcode Number 0 错误码

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/serviceaccount/update");
    OapiServiceaccountUpdateRequest req = new OapiServiceaccountUpdateRequest();
    req.setName("钉三多");
    req.setAvatarMediaId("@lALPBbCc1XuaP_rNAljNAlg");
    req.setBrief("互动服务窗");
    req.setDesc("我是钉三多");
    req.setPreviewMediaId("@lALPBbCc1XuaP_rNAljNAlg");
    req.setUnionid("vfdiPCiSeSXdoiE");
    req.setStatus("0");
    OapiServiceaccountUpdateResponse rsp = client.execute(req, access_token);
    System.out.println(rsp.getBody());

    响应示例

    • JSON示例
    {
        "errmsg":"ok",
        "errcode":0
    }

    异常示例

    • JSON示例
    {
    	"errcode":88,
    	"errmsg":"ding talk error"
    }

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部