上传分析文档

上传单个参考文档，获取可用于独立文章分析的文件地址与元信息。

v1文件上传 Bearer 鉴权

POSThttps://popto.cn/api/open/v1/toolbox/wechat_article_analysis/upload

鉴权与请求头

在 API 密钥管理 ↗ 创建密钥，每次请求在 HTTP Header 中携带。

AuthorizationBearer <POPTO_API_KEY>必填

Content-Typemultipart/form-data必填

请求参数 Form Data

filefile必填

单个文档文件，最大 50 MiB。支持 PDF、Word、PPT、Excel、CSV/TSV、OpenDocument、EPUB、HTML/MHTML 和 OFD。

返回值与结构

成功时 ret = 0，业务数据位于 data.ent。以下为 data.ent 中的字段。

file_urlstring

可用于分析的文档 URL。

file_namestring

文件名称。

mime_typestring

文件 MIME 类型。

sizeinteger

文件大小，字节。

调用说明

使用 multipart/form-data，字段名必须为 file。由客户端自动生成 Content-Type 边界。
单个文件最大 50 MiB，不支持空文件。上传后再提交分析任务。

处理业务响应

HTTP 200 仍可能返回业务错误，请同时检查 ret、code 和 msg。查看响应与错误码

请求示例Request

bash

curl --request POST \
  'https://popto.cn/api/open/v1/toolbox/wechat_article_analysis/upload' \
  --header "Authorization: Bearer $POPTO_API_KEY" \
  --form 'file=@reference.pdf'

成功响应200 OK

json

{
  "ret": 0,
  "msg": "success",
  "data": {
    "ent": {
      "file_url": "https://cdn.example.com/reference.pdf",
      "file_name": "reference.pdf",
      "mime_type": "application/pdf",
      "size": 1024
    }
  }
}

示例内容用于说明结构。任务 ID、积分和执行结果以实际响应为准。