注册互动卡片回调地址

POST

https://oapi.dingtalk.com/topapi/im/chat/scencegroup/interactivecard/callback/register

**
接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口注册互动卡片的回调地址。注册后，开发者后台系统可感知到用户对卡片的操作。

权限

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

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	是	开发者后台申请	调试
第三方个人应用	否	—	—

错误码

错误码（errorcode）	错误码描述（errmsg）	解决方案
40036	入参为空	根据接口要求，传入必要参数。
660009	回调地址为空	请传入回调地址。
660019	回调地址 Url 解析失败	确认传入的回调地址是否合法。
-1	系统异常	重试后如果还是出现此错误，请在开发者后台提交工单。

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://oapi.dingtalk.com/topapi/im/chat/scencegroup/interactivecard/callback/register?access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
        "callback_url":"https://www.dingtalk.com",
        "api_secret":"bgRtxxxx"
}'

响应示例

{
    "errcode": 0,
    "errmsg": "string",
    "result": "string",
    "success": true,
    "request_id": "string"
}

修改于 2024-01-10 07:23:30

更新钉钉互动卡片

人与人会话中机器人发送互动卡片

注册互动卡片回调地址

权限#

错误码#

请求参数

返回响应

权限

错误码