文件下载(算法编码：8000300012)

接口信息

API Path
/aipaas/lm/v1/excel/get

请求协议
HTTP

请求方法
POST

请求头部：

头部标签	必填	说明	类型	数据字典	限制	头部内容	示例
Content-Type	是	application/json	[string]			application/json	application/json
X-APP-ID	是	买家中心-已购能力-【X-APP-ID】	[string]
Device-Uuid	否	设备管理-设备uuid	[string]
Authorization	是	鉴权信息	[string]

请求参数 Json：

参数名	说明	必填	类型	数据字典	限制	示例
seq_id	请求ID，最大长度64	是	[string]
file_uuids	文件uuid，最大size为100	是	[array]

响应内容：

返回结果

> 成功 (200)
> Json
> Object

参数名	说明	必填	类型	数据字典	限制	示例
code	错误码	是	[int]
message	响应描述信息	是	[string]
seq_id	请求ID	是	[string]
data	响应结果数据，成功上传返回该字段，失败不返回此字段	否	[object]
data>>file_list	上传成功的文件列表	是	[array]
data>>file_list>>file_uuid	成功入库文件uuid	是	[string]
data>>file_list>>file_url	下载url，使用该url，通过开发指南-异步调用结果获取-获取大模型生成结果文件信息接口获取最终文件信息	是	[string]

成功示例[Mock API]：

{
    "code": 10000,
    "message": "ok",
    "seq_id": "gfgigqhoqrg",
    "data": {
        "file_list": [{
                "file_uuid": "d12fd037-19df-4973-a246-290673b6407a",
                "file_url": "/bucket1/jbsirgw "
            },
            {
                "file_uuid": "fa830270-9240-403f-a5da-4db77bb20250",
                "file_url": "/bucket1/jbsirgwomjhmjh "
            }
        ]
    }
}

失败示例[Mock API]：

{
    "code": 10001,
    "message": "文件格式错误",
    "seq_id": "gfgigqhoqrg"
}

1. 功能简介

该接口用于批量下载表格理解功能已上传的文档，调用该接口之后获取到的资源地址，需要结合开发指南中的获取大模型生成结果文件信息接口获取最终文件信息。

2. 服务鉴权

服务接口调用时需要严格遵循服务鉴权规则，服务调用鉴权规则请参见：开发指南 - 签名认证方式。

3. 请求参数示例

{
    "seq_id": "gfgigqhoqrg",
    "file_uuids": ["a46d934b-47af-4d28-97c1-7bfad62397be"]
}

4. 状态码说明

通用状态码请参见【状态码】中的【网关认证】和【通用业务】, 接口相关状态码如下：

编码	描述信息
10000	正确返回
10001	文件读取错误或列表为空
10002	文件格式错误
10003	base64解码错误
10004	md5校验失败
10005	文件上传失败
10006	数据存储失败
10007	csv或excel不是标准格式，解码失败
10008	检索文件id不存在
10009	删除文件id不存在
10010	删除文件失败
10011	上传文件为空
10012	文件上传解析失败
10013	未找到对应uuid的文件
10030	请求参数错误
19999	未知错误

5. 调用示例

5.1 Java版本

import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import cn.hutool.json.JSONUtil;

import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/** 主类，用于发起HTTP请求并处理响应 */
public class Example {

    public static void main(String[] args) {
        example();
    }

    /**
     * 方法中使用到的 JSONUtil、HttpRequest、HttpResponse均来自Hutool工具类。
     * 具体maven依赖为：
     * 
     *     cn.hutool
     *     hutool-all
     *     5.8.29
     * 
     */
    public static void example() {
        try {
            String url = "算法调用地址";
            // 设置请求头
            Map headers = new HashMap();
            //调用鉴权
            headers.put("Content-Type", "application/json");
            headers.put("X-APP-ID", "yourAppId");
            headers.put("Authorization", "yourAuthorization");
            // 创建请求对象
            Map request = new HashMap();
            request.put("seqId", "test001");
            request.put("file_uuids", Arrays.asList("a46d934b-47af-4d28-97c1-7bfad62397be"));
            // 将请求对象转换为JsonNode
            String requestString = JSONUtil.toJsonStr(request);

            // 发起HTTP请求
            HttpResponse response =
                    HttpRequest.post(url)
                            .headerMap(headers, true)
                            .body(requestString)
                            .execute();
            // 输出响应结果
            System.out.println(response.body());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

}

5.2 Python版本

import time
import requests
import warnings
from datetime import datetime
import logging

# 配置日志，设置日志级别为INFO，并指定日志格式
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')

# 配置环境变量
X_APP_ID = "yourAppId"
AUTHORIZATION = "yourAuthorization"

# URL 和请求数据
url = "算法调用地址"  # 请求的URL
request_data = {
    "seq_id": "gfgigqhoqrg",
    "file_uuids": ["a46d934b-47af-4d28-97c1-7bfad62397be"]
}

# 构建请求头
headers = {
    "Content-Type": "application/json",
    "X-APP-ID": X_APP_ID,
    "Authorization": AUTHORIZATION
}


def timeSimple(timestamp):
    # 将时间戳转换为HH:MM:SS格式的时间字符串
    dt_object = datetime.fromtimestamp(timestamp)
    formatted_time = dt_object.strftime("%H:%M:%S")
    return formatted_time


def send_request(url):
    try:
        start_time = time.time()
        logging.info(f"请求路径: {url}")
        logging.info(f"开始发送: {timeSimple(start_time)}")

        with requests.post(
            url, json=request_data, headers=headers, stream=True, verify=False
        ) as response:
            first_packet_time = None
            if response.status_code == 200:
                logging.info(f"接受到返回: {timeSimple(time.time())}")

                for chunk in response.iter_content(chunk_size=1024):
                    if chunk:
                        if first_packet_time is None:
                            first_packet_time = time.time()
                        logging.info(
                            f"Received chunk: {timeSimple(time.time())} {chunk.decode('utf-8')}"
                        )

                end_time = time.time()
                logging.info(f"Time to first byte (TTFB): {first_packet_time - start_time:.3f} seconds")
                logging.info(f"Request completed in {end_time - start_time:.3f} seconds")
            else:
                logging.error(f"Request failed with status code {response.status_code}")
    except Exception as e:
        logging.error(f"An error occurred: {e}")


# 发送请求
send_request(url)
logging.info(f"headers = {headers}")