请问钉钉怎么通过服务端api获取用户发起的审批？

要通过调用服务端API获取用户发起的审批流程（基于发起人userId，而非审批人），可以参考以下步骤和说明：

1. 明确需求与适用API

根据您的需求，您需要获取的是发起人发起的审批流程，而不是审批人相关的审批信息。在提供的参考资料中，虽然没有直接提到一个专门用于查询发起人审批流程的API，但可以通过以下方式间接实现： - 使用类似QueryApprovalInfo API，该接口支持根据用户ID（UserId）查询审批流信息。 - 确保传入的UserId为发起人的用户ID，并结合其他参数筛选出由该用户发起的审批记录。

2. 调用API的具体步骤

请求参数

以下是调用QueryApprovalInfo API时的关键参数配置： - UserId (必填)：当前用户的ID（即发起人的UserId）。 - Status (必填)：审批状态，取值如下： - 0：待审批 - 1：已处理 - PageSize (可选)：每页显示的记录数，默认为1000。 - Page (可选)：当前页数，默认为1。

示例请求

假设您需要查询用户ID为12352fasdavsa的发起人所创建的所有审批记录，且状态为“已处理”（Status=1），可以构造如下请求：

{
  "UserId": "12352fasdavsa",
  "Status": 1,
  "PageSize": 1000,
  "Page": 1
}

3. 解析返回结果

调用成功后，API会返回包含审批流信息的JSON数据。以下是返回结果中的关键字段说明： - ApplicantId：申请人ID（即发起人ID）。 - ApplicantName：申请人昵称。 - ApplicationId：申请ID，唯一标识一次审批流程。 - ApplyReason：申请理由。 - FlagStatus：审批状态，取值如下： - 0：审批中 - 1：审批通过 - 2：审批拒绝 - GmtCreate：申请创建时间（时间戳格式）。 - GmtModified：申请修改时间（时间戳格式）。 - ResourceId：申请权限资源ID。 - ResourceName：资源名称。 - ResourceType：资源类型（如DASHBOARD）。

示例返回

{
  "RequestId": "D787E1A3-A93C-424A-B626-C2B05DF8D885",
  "Result": {
    "Data": [
      {
        "ApplicantId": "12352fasdavsa",
        "ApplicantName": "张三",
        "ApplicationId": "64813ef6da58e80eef8ed2f9",
        "ApplyReason": "开发需要",
        "FlagStatus": 1,
        "GmtCreate": 1687315758,
        "GmtModified": 1640595729000,
        "ResourceId": "acl-ct4t2e4u2x4ej1bzur",
        "ResourceName": "测试资源",
        "ResourceType": "DASHBOARD"
      }
    ],
    "Page": 1,
    "PageSize": 1000,
    "Total": 1
  },
  "Success": true
}

4. 注意事项

• 权限要求：调用此API需要具备相应的权限，确保调用者有访问审批流信息的权限。
• 错误处理：如果调用失败，可能会返回以下常见错误码，请根据提示排查问题：
  • Invalid.Parameter.Error：无效参数。
  • Invalid.User.Organization：用户不在组织中。
  • Parameter.Error：输入参数无效。
• 分页处理：如果返回的审批记录较多，需根据Page和PageSize参数进行分页查询。

5. 总结

通过调用QueryApprovalInfo API并指定发起人的UserId，您可以获取该用户发起的所有审批流程信息。请确保正确设置请求参数，并根据返回结果解析审批详情。如果有进一步的需求或遇到问题，建议参考相关API文档或联系技术支持团队。