jdy
    jdy
    • 开发指南
    • app
      • 用户应用查询接口
        POST
      • 用户表单查询接口
        POST
    • formdata
      • form
        • 表单字段查询接口V5
      • data
        • 查询单条数据接口
        • 查询多条数据接口
        • 新建单条数据接口
        • 新建多条数据接口
        • 修改单条数据接口
        • 修改多条数据接口
        • 删除单条数据接口
        • 删除多条数据接口
    • file
      • 获取文件上传凭证和上传地址接口
        POST
      • 文件上传接口
        POST
    • corp
      • user
        • 获取成员信息接口
        • 添加成员接口
        • 修改成员接口
        • 删除成员接口
        • 批量删除成员接口
        • 增量导入成员接口
      • department
        • （递归）获取部门成员接口
        • （递归）获取部门列表接口
        • 创建部门接口
        • 修改部门接口
        • 删除部门接口
        • 获取集成模式部门编号接口
        • 全量导入部门接口
      • role
        • 列出角色接口
        • 创建一个自建角色
        • 更新一个自建角色
        • 删除一个自建角色
        • 列出角色下的成员
        • 为自建角色批量添加成员
        • 为自建角色批量移除成员
      • role_group
        • 列出自建角色组
        • 创建自建角色组
        • 更新自建角色组
        • 删除自建角色组
      • guest
        • 列出我连接的企业
        • 列出我连接的企业的对接人
        • 获取我连接的企业对接人的详细信息
    • workflow
      • 获取单条流程表单数据的审批意见
        POST
      • 查询流程实例信息
        POST
      • 结束流程实例
        POST
      • 流程待办查询
        POST
      • 流程待办提交
        POST
      • 流程待办回退
        POST
      • 流程待办转交
        POST
      • 查询流程日志
        POST
      • 激活流程实例
        POST

    文件接口

    文件接口
    由Peach创建，最新修改于2023-03-15

    1. 开发准备#

    开发前，请仔细阅读 开发指南。

    2. 文件API#

    2.1 获取文件上传凭证和上传地址接口#

    获取文件上传凭证和上传地址接口
    接口版本说明：
    接口版本更新时间版本说明
    v12021.12.30原始接口
    v52022.10.28在 v1 的基础上，接口请求频率由 5 次/秒提升至 20 次/秒；参数 app_id 和 entry_id 放入 body，接口路由修改为 POST app/entry/file/get_upload_token。
    **请求地址：**https://api.jiandaoyun.com/api/v5/app/entry/file/get_upload_token
    请求频率： 20 次/秒
    **请求方式：**POST
    接口说明：
    每次请求会获取 100 个文件上传凭证和上传地址，上传的文件会与 transaction_id 绑定，只有相同 transaction_id 的创建或修改请求才能使用该文件。
    请求参数：
    参数必需类型说明
    app_idString是应用ID
    entry_idString是表单ID
    transaction_idString是事务ID
    请求数据样例：
    1
    {
    2
     "app_id": "59264073a2a60c0c08e20bfb",
    3
      "entry_id": "59264073a2a60c0c08e20bfd",
    4
      "transaction_id": "87cd7d71-c6df-4281-9927-469094395677"   //事务ID
    5
    }
    响应内容：
    参数类型说明
    token_and_url_listJSON文件上传凭证和上传地址
    token_and_url_list[].urlString文件上传地址
    token_and_url_list[].tokenString文件上传凭证
    响应示例：
    1
    {
    2
        "token_and_url_list": [
    3
            {
    4
                "url": "https://upload.qiniup.com",
    5
                "token": "bM7UwVPyBBdPaleBZt21SWKzMy2qPUpn-05jZlas:ELIqACNut-t52UMPD-DZNrX8hTU=:eyJmc2l6ZU1pbiI6MSwiZnNpemVMaW1pdCI6MjA5NzE1MjAwLCJjYWxsYmFja0JvZHlUeXBlIjoiYXBwbGljYXRpb24vanNvbiIsImNhbGxiYWNrQm9keSI6IntcImFwcElkXCI6XCI2MWFjNzcxNTE0MjU3NDM2ODhlZWMwYzRcIixcImVudHJ5SWRcIjpcIjYxYWM3NzNhMTQyNTc0MzY4OGVlYzBjN1wiLFwia2V5XCI6XCIkKGtleSlcIixcImhhc2hcIjpcIiQoZXRhZylcIixcIm5hbWVcIjpcIiQoZm5hbWUpXCIsXCJzaXplXCI6XCIkKGZzaXplKVwiLFwibWltZVwiOlwiJChtaW1lVHlwZSlcIixcImJ1Y2tldFwiOlwiamR5LWZpbGVcIixcInVwbG9hZGVyXCI6XCI2MTFhMmQzNjRmMzQ3MDAwMDY3NWM5ZGRcIixcInNlc3Npb25JZFwiOlwic3NkXCJ9IiwiY2FsbGJhY2tIb3N0IjoiNTA3NS0xMTQtMjI0LTE3LTIxNi5uZ3Jvay5pbyIsImNhbGxiYWNrVXJsIjoiaHR0cDovLzUwNzUtMTE0LTIyNC0xNy0yMTYubmdyb2suaW8vZmlsZS91cGxvYWQvYXBpX2NhbGxiYWNrIiwiZm9yY2VTYXZlS2V5Ijp0cnVlLCJzYXZlS2V5IjoiYTJjOTkwY2ItMTlhZS00NDgwLTkyYzYtZDI3N2I5ZGQ2MmFhIiwic2NvcGUiOiJkbi1qZHktdXBsb2FkIiwiZGVhZGxpbmUiOjE2Mzk0ODU2NjV9"
    6
            },
    7
            {
    8
                "url": "https://upload.qiniup.com",
    9
                "token": "bM7UwVPyBBdPaleBZt21SWKzMylqPUpn-05jZlas:inKpUPPCKIWJ6CnZzHrRPnjXwio=:eyJmc226ZU1pbiI6MSwiZnNpemVMaW1pdCI6MjA5NzE1MjAwLCJjYWxsYmFja0JvZHlUeXBlIjoiYXBwbGljYXRpb24vanNvbiIsImNhbGxiYWNrQm9keSI6IntcImFwcElkXCI6XCI2MWFjNzcxNTE0MjU3NDM2ODhlZWMwYzRcIixcImVudHJ5SWRcIjpcIjYxYWM3NzNhMTQyNTc0MzY4OGVlYzBjN1wiLFwia2V5XCI6XCIkKGtleSlcIixcImhhc2hcIjpcIiQoZXRhZylcIixcIm5hbWVcIjpcIiQoZm5hbWUpXCIsXCJzaXplXCI6XCIkKGZzaXplKVwiLFwibWltZVwiOlwiJChtaW1lVHlwZSlcIixcImJ1Y2tldFwiOlwiamR5LWZpbGVcIixcInVwbG9hZGVyXCI6XCI2MTFhMmQzNjRmMzQ3MDAwMDY3NWM5ZGRcIixcInNlc3Npb25JZFwiOlwic3NkXCJ9IiwiY2FsbGJhY2tIb3N0IjoiNTA3NS0xMTQtMjI0LTE3LTIxNi5uZ3Jvay5pbyIsImNhbGxiYWNrVXJsIjoiaHR0cDovLzUwNzUtMTE0LTIyNC0xNy0yMTYubmdyb2suaW8vZmlsZS91cGxvYWQvYXBpX2NhbGxiYWNrIiwiZm9yY2VTYXZlS2V5Ijp0cnVlLCJzYXZlS2V5IjoiN2Y4Yzk3NDAtNmI2YS00OTQ0LWE0MzgtNjQ1Y2IzN2ViNmQ0Iiwic2NvcGUiOiJkbi1qZHktdXBsb2FkIiwiZGVhZGxpbmUiOjE2Mzk0ODU2NjV9"
    10
            },
    11
            ……
    12
        ]
    13
    }

    2.2 文件上传接口#

    用于上传文件的接口。
    接口版本说明：
    接口版本更新时间版本说明
    v12021.12.30原始接口
    v52022.10.28在 v1 的基础上，接口请求频率由 5 次/秒提升至 20 次/秒
    请求地址：{url}
    请求频率： 20 次/秒
    **请求方式：**POST
    接口说明：
    此处的 url 为获取文件上传凭证和上传地址接口中获取到的上传地址。
    该接口一个 token 只能上传一个文件，不允许覆盖，返回的 key 用于创建和修改接口填写在附件或图片控件值中。
    请求参数：
    参数必需类型说明
    token是String文件上传凭证
    file是文件要上传的文件
    注：
    1）由于请求中需要上传文件，所以参数为 form-data 形式。
    2）file 需要作为最后一个参数。
    响应内容：
    参数类型说明
    keyString文件key
    响应数据样例：
    1
    {
    2
        "key": "6b559cf1-b16c-43bd-a211-8fa8fdeae2ef"
    3
    }

    3. 注意事项#

    \1. token 的有效时间为 1 小时。
    \2. transaction_id 和 key 配合使用，transaction_id 有效时间也为 1 小时，失效后，key 也将无法使用。
    上一页
    删除多条数据接口
    下一页
    获取文件上传凭证和上传地址接口
    Built with