新增服务号旧版SDK

更新于 2023-01-18

接口调用量说明当前接口为钉钉专属版专用接口，你可升级钉钉专属版(Open API调用量500万次/月)获取接口调用权限以及扩容调用次数。

本接口用于新增一个服务号。

调用本接口效果同以下产品操作效果类似。

接口调用成功后，在互动服务窗列表展示新增的服务号。如下图所示，列表新增“测试服务号”。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

请求方式：POST

请求地址：https://oapi.dingtalk.com/topapi/serviceaccount/add

名称

类型

是否必填

示例值

描述

access_token

String

是

30c9a84136943eaxxxx

调用该接口的应用凭证。

名称	类型	是否必填	示例值	描述
name	String	是	创建服务号	服务号名称。
avatar_media_id	String	是	@lALPBbCc1XuaP_rNAljNAlg	头像图片mediaId，可以通过上传媒体文件接口上传图片获取mediaId。
brief	String	否	互动服务窗	机器人管理列表中的简介。
desc	String	是	我是描述	机器人主页中的服务号功能简介，最多200个字符。
preview_media_id	String	是	@lALPBbCc1XuaP_rNAljNAlg	机器人主页中，消息预览图片的mediaId，可以通过上传媒体文件接口上传图片获取mediaId。

请求示例（HTTP）

请求正文

请求示例（JAVA SDK）

返回示例

这篇文档是否有帮助？

本页内容