Skip to main content
POST
/
v1
/
docs
/
upload
Upload Docs
curl --request POST \
  --url https://api.reportify.cn/v1/docs/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "docs": [
    {
      "url": "<string>",
      "name": "<string>",
      "metadatas": {
        "period": "2023Q4",
        "entities": [
          "公司A",
          "公司B"
        ]
      },
      "published_at": 123,
      "tags": {}
    }
  ],
  "folder_id": "<string>",
  "pdf_parsing_mode": 1
}'
{
  "docs": [
    {
      "id": "<string>",
      "title": "<string>",
      "original_url": "<string>"
    }
  ]
}

​
同步上传文档

URL: /v1/docs/upload
方法: POST
描述: 同步上传单篇报告文档至指定文件夹。

​
请求参数

参数名类型描述
folder_idstr目标文件夹 ID。
docsarray文档数组，每个文档包含以下字段：
  namestr文档名称。
  urlstr文档的互联网 URL 路径。
  published_atstr发布时间，格式为 millisecond timestamp 1712832000000。
  tagsdict标签数组。
    keystr标签类型（如 industry, company, person, event）。
    valuearray标签内容数组。
  metadatasdict元数据字典，包含以下字段：
    keystr元数据类型（如 periods, entities）。
    valuearray元数据内容数组。

​
响应参数

参数名类型描述
docsarray文档数组，每个文档包含以下字段：
  idstr文档唯一 ID
  titlestr文档标题
  original_urlstr文档原始URL

​
请求示例

cURL 
curl -X POST https://api.reportify.cn/v1/docs/upload \
-H "Authorization: Bearer 447460****09c9" \
-H "Content-Type: application/json" \
-d '{
    "folder_id": "folder_12345",
    "name": "Tesla AI Report",
    "url": "https://files.reportify.cn/tesla_report.pdf",
    "metadatas": {
      "periods": "Q4 2023",
      "entities": [
        "Tesla Inc.",
        "TSLA"
      ]
    }
}'
Python 示例 
import requests

url = "https://api.reportify.cn/v1/docs/upload"
headers = {
    "Authorization": "Bearer 447460****09c9",
    "Content-Type": "application/json"
}
payload = {
    "folder_id": "folder_12345",
    "docs": [
        {
            "name": "Tesla AI Report",
            "url": "https://files.reportify.cn/tesla_report.pdf",
            "metadatas": {
                "periods": "Q4 2023",
                "entities": [
                    "Tesla Inc.",
                    "TSLA"
                ]
            }
        }
    ]
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

​
响应示例

{
  "docs": [
    {
      "id": "doc_67890",
      "title": "Tesla AI Report",
      "original_url": "https://files.reportify.cn/tesla_report_uploaded.pdf"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
docs
OAIDocsUrlRequest · object[]
required
​
folder_id
string

文件夹ID，不传则使用默认文件夹

​
pdf_parsing_mode
integer
default:1

pdf解析模式: 1-按页,3-按逻辑 @see PDFParsingModeEnum

Response

Successful Response

​
docs
OAIDocsIdResponse · object[]
required