开发者社区> 问答> 正文

在钉钉中互动卡片HTTP回调格式,如何操作?

在钉钉中互动卡片HTTP回调格式,如何操作?

展开
收起
冲冲冲c 2024-08-27 15:38:00 41 0
1 条回答
写回答
取消 提交回答
  • 互动卡片的HTTP回调格式依据不同的场景会有所不同,以下是几个典型的示例:动态数据源回调响应示例当处理动态数据源回调请求后,需要返回以下格式的响应来更新卡片上的动态数据:

    {
      "dataSourceQueryResponses": [
        {
          "data": "{\"amount\":\"1000元\"}", // 返回的动态数据,端上直接覆盖并渲染
          "dynamicDataSourceId": "example_ds_1", // 动态数据源 ID
          "dynamicDataValueType": "OBJECT" // 动态数据的类型,支持 STRING、ARRAY、OBJECT 等
        }
      ]
    }
    

    事件回调示例接收事件回调时,钉钉服务器发送的请求格式如下:

    
    {
      "type": "actionCallback",
      "outTrackId": "XXXXXX",
      "corpId": "dingXXXXXX",
      "userId": "XXXXXX",
      "content": "{\"cardPrivateData\":{\"actionIds\":[\"1\"],\"params\":{\"action\":\"accept\"}}}"
    }
    

    其中 content 字段解析后表示具体的交互数据。成员资料页扩展互动卡片能力的Http回调入参示例在成员资料页扩展互动卡片场景中,入参数据模型可能包含:• actionIds:点击选中的前端控件ID。• params:数据回传的具体参数。而对应的响应数据模型例子为:

        "dataSourceQueryResponses": [
            {
                "data": "{\"profileUrl\":\"www.dingtalk.com\",\"profilePcUrl\":\"www.dingtalk.com\",\"isProfileOwner\":false,\"okrs\":[{\"name\":\"这是小钉小号新的目标,(进度会刷新)\",\"progress\":40}]}",
                "dynamicDataSourceId": "ds.profile",
                "dynamicDataValueType": "OBJECT"
            }
        ]
    }
    

    回答整理来自钉群“钉钉开发者社区(互助群)”。

    2024-08-27 17:23:24
    赞同 5 展开评论 打赏
来源圈子
更多
收录在圈子:
+ 订阅
问答排行榜
最热
最新

相关电子书

更多
钉钉小程序——为工作方式插上翅膀 立即下载
钉钉客户端自动化的应用 立即下载
使命必达 —— 钉钉企业级 消息服务的机遇与挑战 立即下载