Skip to content
ComPDF

使用与支持:API 调用、常见问题与支持入口


1. API 调用:PDF 转 Excel 示例

1.1 接口说明

  • URL:http://<EC2_PUBLIC_IP>:7000/file/handle
  • Method:POST
  • Content-Type:multipart/form-data
  • 返回:application/octet-stream(文件流)

1.2 curl 示例(保存输出文件)

以下示例将返回文件保存为 test-excel.xlsx

bash
curl --location --request POST "http://<EC2_PUBLIC_IP>:7000/file/handle" \
  --output "test-excel.xlsx" \
  --form 'file=@"./input.pdf"' \
  --form 'executeType="pdf/xlsx"' \
  --form 'password=""' \
  --form 'resultFileName="test-excel"' \
  --form 'language="2"' \
  --form 'parameter="{  \"enableAiLayout\": 1,  \"isContainImg\": 1,  \"isContainAnnot\": 1,  \"enableOcr\": 1,  \"ocrLanguage\": 8,  \"pageRanges\": \"1,2,3-5\",  \"excelAllContent\": 1,  \"excelWorksheetOption\": \"e_ForTable\"}"'

2. 常见问题(Troubleshooting)

2.1 7000 端口无法访问

请依次检查:

  1. EC2 安全组是否已放行 7000/tcp
  2. 客户端是否能访问实例公网 IP(或你是否应使用内网 IP)
  3. 容器是否运行:sudo docker ps
  4. 查看服务日志:sudo docker logs -f compdfkit_processor

2.2 License 无效/授权报错

  1. 确认已在 /var/www/compdf/docker-compose.yml 中替换 LICENSE_KEY
  2. 重新创建容器使环境变量生效:
    bash
    cd /var/www/compdf
    sudo docker compose down
    sudo docker compose up -d
  3. 查看日志定位授权错误:
    bash
    sudo docker logs -f compdfkit_processor

2.3 数据库异常

  1. 查看数据库日志:sudo docker logs -f dbmysql
  2. 检查磁盘空间是否充足(转换任务与数据库都可能占用空间)
  3. 如你修改了数据库密码,请同步更新 compose 中的 DB_PASSWORD 与 MySQL 环境变量

3. 支持与购买咨询

  • 许可证购买及销售咨询:许可证购买及商务咨询请联系销售团队,我们将在 24 小时内与您取得联系。