POST
/
v1
/
docs
/
upload
curl --request POST \
  --url https://api.reportify.cn/v1/docs/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "folder_id": 123,
  "docs": [
    {
      "url": "<string>",
      "name": "<string>",
      "metadatas": {
        "period": "2023Q4",
        "entities": [
          "companyA",
          "companyB"
        ]
      }
    }
  ]
}'
{
  "docs": [
    {
      "id": "<string>",
      "title": "<string>",
      "original_url": "<string>"
    }
  ]
}

​
同步上传文档

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

​
请求参数

参数名类型描述
folder_idstr目标文件夹 ID。
docsarray文档数组，每个文档包含以下字段：
  namestr文档名称。
  urlstr文档的互联网 URL 路径。
  metadatasdict元数据字典，包含以下字段：
    keystr元数据类型（如 period, 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": {
      "period": "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": {
                "period": "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
object[]
required
​
folder_id
integer

folder id, if not provided, use default folder

Response

200
application/json
Successful Response
​
docs
object[]
required