帆软社区
首页 服务平台 文档 学院 问答 论坛 认证 招聘 任务 市场
数跨境文档

上传数据表

  • 文档创建者：Naya
  • 历史版本：1

    • 1. 概述

    本页面所有接口均需要临时令牌。请先使用您的 accessKeyId 和 accessKeySecret 获取，详见 登录认证。

    访问接口时在设置中将 Value 替换为您的临时令牌。

    1.png

    2. 开启API数据源

    接口简介：



    接口作用开启API数据源
    接口URL/api/v1/datasource/status/modify
    请求参数{"status":"1"}
    请求类型POST

    响应实例：




    请求示例

    https://work.jiushuyun.com/decision/api/v1/datasource/status/modify

    响应成功

    {

        "success": true,

        "code": "200",

        "message": "success",

        "data": [],

        "errorCode": null,

        "detailErrorMsg": null,

        "errorMsg": null

    }

    截图示例

    Group 28.png

    开启后，可在数据连接市场看到 API 数据源入口。如下图所示：
    Group 29.png

    3. 分组管理

    3.1 创建分组

    接口简介：



    接口作用创建分组
    接口URL

    /api/v1/datasource/group/create

    请求参数{"groupName":"#分组名"}
    请求类型POST

    响应实例：



    请求示例

    https://work.jiushuyun.com/decision/api/v1/datasource/group/create

    响应成功

    {

        "success": true,

        "code": "200",

        "message": "success",

        "data": "c65201928c874a41bdb7ee199b2684db",

        "errorCode": null,

        "detailErrorMsg": null,

        "errorMsg": null

    }

    截图示例

    Group 30.png


    3.2 读取所有分组

    接口简介：



    接口作用读取所有分组
    接口URL

    /api/v1/datasource/group/list

    请求类型POST

    响应实例：



    请求示例

    https://work.jiushuyun.com/decision/api/v1/datasource/group/list

    响应成功

    {

        "success": true,

        "code": "200",

        "message": "success",

        "data": [

            {

                "id": "34e7e1bee25e42c8a7e48cb6096c9ec5",

                "name": "API测试"

            },

            {

                "id": "c65201928c874a41bdb7ee199b2684db",

                "name": "API 数据表"

            }

        ],

        "errorCode": null,

        "detailErrorMsg": null,

        "errorMsg": null

    }

    截图示例

    Group 31.png

    3.3 读取分组下的所有表

    接口简介：



    接口作用读取分组下的所有表
    接口URL

    /api/v1/datasource/group/table/list

    请求参数{"groupId":"#分组Id"}
    请求类型POST

    响应实例：



    请求示例

    https://work.jiushuyun.com/decision/api/v1/datasource/group/table/list

    响应成功

    {

        "success": true,

        "code": "200",

        "message": "success",

        "data": [

            {

                "id": "d38dd9f6ead140648535275496a4177c",

                "name": "销售数据表"

            }

        ],

        "errorCode": null,

        "detailErrorMsg": null,

        "errorMsg": null

    }


    截图示例

    Group 32.png

    3.4 修改分组名

    接口简介：



    接口作用修改分组名
    接口URL

    /api/v1/datasource/group/modify

    请求参数{"groupId":"#分组Id","groupName":"#新的分组名"}
    请求类型POST

    响应实例：




    请求示例

    https://work.jiushuyun.com/decision/api/v1/datasource/group/modify

    响应成功

    {

        "success": true,

        "code": "200",

        "message": "success",

        "data": [],

        "errorCode": null,

        "detailErrorMsg": null,

        "errorMsg": null

    }

    截图示例

    Group 33.png

    3.5 删除分组

    接口简介：



    接口作用删除分组(分组下有表存在时无法删除)
    接口URL

    /api/v1/datasource/group/delete

    请求参数{"groupId":"#分组Id"}
    请求类型POST

    响应实例：



    请求示例

    https://work.jiushuyun.com/decision/api/v1/datasource/group/delete

    响应成功

    {

        "success": true,

        "code": "200",

        "message": "success",

        "data": [],

        "errorCode": null,

        "detailErrorMsg": null,

        "errorMsg": null

    }

    截图示例

    Group 34.png

    4. 表管理

    4.1 创建数据源表

    接口简介：



    接口作用创建数据源表
    接口URL

    /api/v1/datasource/table/create

    请求参数{"tableName":"#表名","groupId":"#分组Id","updateMode":1（可选1,2,3或不上传默认为1）}
    请求类型POST
    备注

    updateMode: 更新方式

    1：全量更新:用全新的数据替换旧的全部数据（数据可以做到新增、修改、删除，但是耗费资源较多，表数据量大时可能会比较慢，表数据量小时推荐使用，每次替换大规模数据时推荐使用）；

    2：增量更新:新增新数据，旧数据不受影响（数据无法更新、删除，只能新增，记录历史数据无需修改和删除时推荐使用，效率最高）；

    3：替换更新:（必须声明主键）按主键替换相同主键的数据，之前没有的数据直接新增。（主键处理见csv文件说明）（数据只能替换、新增，不能删除，每次更新会修改少量数据时推荐使用）

    响应实例：



    请求示例

    https://work.jiushuyun.com/decision/api/v1/datasource/table/create

    响应成功

    {

        "success": true,

        "code": "200",

        "message": "success",

        "data": "18c5c6d790364b9091be37b45ed52372",

        "errorCode": null,

        "detailErrorMsg": null,

        "errorMsg": null

    }

    截图示例

    Group 35.png

    4.2 获取表数据上传地址

    接口简介：



    接口作用获取表数据上传地址
    接口URL

    /api/v1/datasource/table/upload/url

    请求参数{"tableId":"#表Id"}
    请求类型POST
    说明

    • 获取数据上传地址后，使用put请求调用，csv文件使用二进制上传

    • 本文档提供的上传地址、下载地址等链接，过期时间均为24h

    响应实例：



    请求示例

    https://work.jiushuyun.com/decision/api/v1/datasource/table/upload/url

    响应成功

    {

        "success": true,

        "code": "200",

        "message": "success",

        "data": "https://qfx30.oss-cn-hangzhou.aliyuncs.com/qfx3/sync/18c5c6d790364b9091be37b45ed52372.csv?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20241231T023734Z&X-Amz-SignedHeaders=host&X-Amz-Expires=86400&X-Amz-Credential=LTAI4GKmR7rpd5thHtVrBHpv%2F20241231%2Foss-cn-hangzhou.aliyuncs.com%2Fs3%2Faws4_request&X-Amz-Signature=b6b18bde22722d2b53f84d75684990c38d30faf0607a9e37aa8b16a2958676ff",

        "errorCode": null,

        "detailErrorMsg": null,

        "errorMsg": null

    }

    截图示例

    Group 36.png

    4.3 标记表数据已上传完成

    接口简介：



    接口作用标记表数据已上传完成
    接口URL

    /api/v1/datasource/table/upload/finish

    请求参数{"tableId":"#表Id"}
    请求类型POST
    说明创建表的动作是异步处理的，因此有可能存在调用标记数据上传完成接口时表未创建完成的情况，推荐在调用前等待3秒

    响应实例：



    请求示例

    https://work.jiushuyun.com/decision/api/v1/datasource/table/upload/finish

    响应成功

    {

        "success": true,

        "code": "200",

        "message": "success",

        "data": "18c5c6d790364b9091be37b45ed52372",

        "errorCode": null,

        "detailErrorMsg": null,

        "errorMsg": null

    }

    截图示例

    Group 37.png

    4.4 修改数据源表名、更新方式

    接口简介：



    接口作用修改数据源表名、更新方式
    接口URL

    /api/v1/datasource/table/modify

    请求参数 {"tableId":"#表Id","tableName":"#新的表名","updateMode": 1（可选1,2,3或不上传默认为1，说明见本文 4.1 节)}
    请求类型POST

    响应实例：




    请求示例

    https://work.jiushuyun.com/decision/api/v1/datasource/table/modify

    响应成功

    {

        "success": true,

        "code": "200",

        "message": "success",

        "data": [],

        "errorCode": null,

        "detailErrorMsg": null,

        "errorMsg": null

    }

    截图示例

    Group 38.png

    4.5 删除数据源表

    接口简介：



    接口作用删除数据源表
    接口URL

    /api/v1/datasource/table/delete

    请求参数{"tableId":"#表Id"}
    请求类型POST

    响应实例：




    请求示例

    https://work.jiushuyun.com/decision/api/v1/datasource/table/delete

    响应成功

    {

        "success": true,

        "code": "200",

        "message": "success",

        "data": [],

        "errorCode": null,

        "detailErrorMsg": null,

        "errorMsg": null

    }

    截图示例

    Group 39.png


    4.6 重置整个数据源

    接口简介：



    接口作用重置整个数据源
    接口URL

    /api/v1/datasource/reset

    请求类型POST


    附件列表


    主题： 开放平台
    上一篇：读取分析表
    下一篇：性能优化指导手册
    • 有帮助
    • 没帮助
    • 只是浏览

    鼠标选中内容，快速反馈问题

    鼠标选中存在疑惑的内容，即可快速反馈问题，我们将会跟进处理。

    不再提示

    9s后关闭

    联系我们
    在线支持
    获取专业技术支持，快速帮助您解决问题
    工作日9:00-12:00，13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线：400-811-8890转2
    总裁办24H投诉：17312781526
    提交页面反馈
    仅适用于当前网页的意见收集，帆软产品问题请在 问答板块提问 或 前往服务平台 获取技术支持

    反馈已提交

    网络繁忙