- Overview of OpenAPI
- SlackOpenAPI
- ShopifyOpenAPI
- GithubAPI
- DiscordOpenAPI
- 历史文档(不推荐)
- 开发钉钉应用
- 服务端API
- 新版服务端API(DingTalk OpenAPI)
- 生态伙伴API
新增服务号
POST
http://127.0.0.1/topapi/serviceaccount/add
服务端API/专属钉钉/互动服务窗/服务号管理
最后修改时间:2022-08-30 09:19:24
责任人:未设置
说明#
服务地址:https://oapi.dingtalk.com
权限#
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 否 | — | — |
第三方个人应用 | 否 | — | — |
错误码#
错误码 | 说明 | 排查方法 |
---|---|---|
800001 | 请勿创建重复名称的服务号 | 修改服务号名称。 |
800004 | 可创建服务号数量达到上限 | 最多允许创建40个。 |
请求参数
Query 参数
access_token
string
必需
示例值:
30c9a84136943eaxxxx
Body 参数application/json
name
string
服务号名称。
avatar_media_id
string
必需
brief
string
可选
desc
string
必需
preview_media_id
string
必需
示例
{
"brief": "互动服务窗",
"preview_media_id": "@lALPBbCc1XuaP_rNAljNAlg",
"name": "创建服务号",
"avatar_media_id": "@lALPBbCc1XuaP_rNAljNAlg",
"desc": "我是描述"
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1/topapi/serviceaccount/add?access_token=30c9a84136943eaxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
"brief": "互动服务窗",
"preview_media_id": "@lALPBbCc1XuaP_rNAljNAlg",
"name": "创建服务号",
"avatar_media_id": "@lALPBbCc1XuaP_rNAljNAlg",
"desc": "我是描述"
}'
返回响应
🟢200成功
application/json
Body
errmsg
string
返回码描述。
errcode
number
返回码。
unionid
string
可选
string
请求ID。
示例
{
"errmsg": "string",
"errcode": 0,
"unionid": "string",
"": "string"
}

修改于 2022-08-30 09:19:24