开发者社区 问答 正文

钉钉DingTalk OpenAPI版本号是如何表示的?

钉钉DingTalk OpenAPI版本号是如何表示的?

展开
收起
三分钟热度的鱼 2023-09-05 21:11:30 171 分享 版权
5 条回答
写回答
取消 提交回答
  • 微信截图_20230924184007.png
    DingTalk OpenAPI版本号采用大版本号+小版本号组合的形式,例如1.0、2.1。同时,SDK版本采用大版本+小版本+补丁版本的形式表示微信截图_20230924183846.png

    2023-09-29 11:40:51
    赞同 展开评论
  • 面对过去,不要迷离;面对未来,不必彷徨;活在今天,你只要把自己完全展示给别人看。

    钉钉的 OpenAPI 版本号使用以下形式进行表示:
    image.png

    v1v2v2.0v2.1 等。
    image.png

    其中,v1 表示第一个版本,后续版本按照递增数字进行命名。在某些情况下,为了引入更多的功能和改进,可能会采用带小数点的版本号(如 v2.0v2.1)。这种形式的版本号通常表示主要版本号和次要版本号之间的差异。

    钉钉的 OpenAPI 版本号通常在 API 调用的 URL 中作为路径的一部分出现,如:

    https://oapi.dingtalk.com/v1/user/get
    https://oapi.dingtalk.com/v2/department/list
    

    这里的 /v1//v2/ 部分就指定了使用的 OpenAPI 版本。

    2023-09-06 16:28:00
    赞同 展开评论
  • DingTalk OpenAPI版本采用大版本号+小版本号组合的形式,例如1.0、2.1。

    小版本号升级(例如从1.0升级到1.1)意味着发布了不向后兼容的API升级。

    大版本号升级时(例如从1.0升级到2.0),上一个版本的API将在一段时间后停止支持。SDK和文档将取消上一个大版本API的入口。

    重要
    当大版本发布后,开发者需尽快升级至最新版本以便获得更好的支持。

    image.png

    接口调用流程
    如下图所示,在调用钉钉服务端接口前,您需要完成以下准备工作:

    70e0e423d73f16fd93281aed91c114d6_p132205.png

    2023-09-06 16:09:30
    赞同 展开评论
  • DingTalk OpenAPI版本号采用大版本号+小版本号组合的形式,例如1.0、2.1。同时,SDK版本采用大版本+小版本+补丁版本的形式表示,例如1.0.0、2.0.11。此回答整理自钉群“钉钉开发者社区(互助群)”

    2023-09-05 21:29:13
    赞同 1 展开评论
  • 钉钉的DingTalk OpenAPI版本号是采用v1v2等形式来表示的。

    具体而言,DingTalk OpenAPI的版本号由两部分组成:

    1. 主版本号(Major Version):表示API的大版本号,通常在API发生较大变化或引入不兼容改动时会更新。例如,v1代表第一个主要版本。

    2. 次版本号(Minor Version):表示API的小版本号,在主版本号不变的情况下,通过次版本号来表示API的增量更新。例如,v1.4代表主版本为v1,次版本为4

    当进行API开发和调用时,建议始终使用最新的稳定版本,并及时关注钉钉开放平台官方文档和公告,以了解最新的版本信息和更新内容。

    2023-09-05 21:26:43
    赞同 展开评论