Safe Remote File Ingestion API

RapidAPI2026-07-11 更新2026-07-12 收录

文件上传安全

应用安全防护

数据链接：

https://rapidapi.com/twoswaglollaw/api/safe-remote-file-ingestion-api 数据链接链接失效反馈

官方服务：

资源简介：

Securely fetch, inspect, and validate remote JPEG, PNG, WebP, and PDF files. Includes built-in SSRF protection, DNS rebinding prevention, real-signature detection, and image transformations prior to uploading directly to your presigned URLs.

创建时间：

2026-07-11

原始信息汇总

数据集概述：Safe Remote File Ingestion API

核心功能
该API用于安全地获取、检查和验证远程的JPEG、PNG、WebP和PDF文件，提供内置的SSRF防护、DNS重绑定预防、真实文件签名检测以及图像转换功能，最终可将验证后的文件直接上传至用户指定的预签名URL。

适用场景

用户粘贴头像、产品图片、收据、文档或个人照片等URL到应用中。
Webhook、自动化流程、AI代理或集成系统从第三方导入图片或PDF。
SaaS产品需要将远程文件复制到S3、Cloudflare R2、Google Cloud Storage、Azure Blob Storage等对象存储中。
需要拒绝伪造扩展名、误导性Content-Type头、格式错误的图像、超大文件、极端图像尺寸或不安全的PDF。
需要对不可信图像进行缩放、自动旋转、去除元数据或格式转换后再发布。
需要结构化的、可审计的验证报告，且不永久存储源文件。
希望防止SSRF攻击，包括通过重定向或DNS变更访问localhost、私有网络、云元数据服务或内部系统。

支持的文件格式

格式	MIME类型	检查	转换
JPEG	`image/jpeg`	是	JPEG, PNG, WebP
PNG	`image/png`	是	JPEG, PNG, WebP
WebP	`image/webp`	是	JPEG, PNG, WebP
PDF	`application/pdf`	是	否

SVG、HTML、压缩包、Office文件、音频和视频在当前版本中被拒绝。

工作流程

验证URL，仅允许HTTP或HTTPS协议。
解析DNS，拒绝私有、回环、链路本地、组播、保留、元数据服务等非公网IP地址。
重新验证每个重定向，并将连接锁定到已批准的IP。
通过临时文件流式传输响应，设置字节数限制和超时限制。
使用文件签名检测真实格式，不信任URL或HTTP头。
完全解码图像或结构化解析PDF。
应用用户定义的验证策略。
可选地对已批准的图像进行标准化处理。
可选地将最终批准的字节上传到用户提供的HTTP PUT目的地。
删除所有临时文件，返回结构化报告。

主要端点

POST /v1/files/validate-url — URL和DNS安全验证（不下载文件）。
POST /v1/files/inspect — 临时下载和验证，返回报告后删除文件。
POST /v1/files/ingest — 完整检查 + 可选的图像转换 + 可选的上传至预签名URL。
GET /v1/ingestions/{id} — 获取最近完成的摄取报告（报告范围限定于已认证用户，自动过期）。
GET /v1/file-types — 获取支持的类型、转换规则和硬限制。
GET /v1/health — 服务活性检查。
GET /ready — 依赖项就绪检查。

重要问题代码

代码	含义
`UNSAFE_URL`	协议、凭证、主机名或URL格式不安全
`PRIVATE_IP_ADDRESS`	URL解析到非公网地址
`DNS_REBINDING_DETECTED`	连接的节点与验证的DNS结果不一致
`TOO_MANY_REDIRECTS`	超过重定向策略限制
`DOWNLOAD_TIMEOUT`	源请求超时
`FILE_TOO_LARGE`	文件超过字节数策略限制
`UNSUPPORTED_FILE_TYPE`	文件签名不受支持或不允许
`MIME_TYPE_MISMATCH`	HTTP MIME类型与文件签名不一致
`MALFORMED_IMAGE`	图像无法完全解码
`IMAGE_DIMENSIONS_EXCEEDED`	宽度或高度超过策略限制
`IMAGE_PIXEL_LIMIT_EXCEEDED`	解码后的像素数超过策略限制
`MALFORMED_PDF`	PDF无法结构化解析
`ENCRYPTED_PDF_NOT_ALLOWED`	策略拒绝加密PDF
`PDF_JAVASCRIPT_PRESENT`	检测到PDF中的JavaScript
`PDF_EMBEDDED_FILES_PRESENT`	检测到PDF附件
`TRANSFORMATION_FAILED`	图像标准化失败
`DESTINATION_UPLOAD_FAILED`	预签名PUT验证或交付失败