向 Analyzer baseUris 端点发送经过身份验证的 GET 请求:
确定组织的区域 API 端点,对您的请求进行身份验证,并使用 Acrobat API 中的 Analyzer。
在调用 Analyzer API 之前,请解析组织的 API 访问点。Analyzer 目前支持 NA1 和 EU1 区域。
准备事项
完成为 Acrobat 中的 Analyzer 设置 API 访问权限流程,并拥有有效的 OAuth 服务器到服务器访问令牌。
确定区域 API 端点
Analyzer 使用 baseUris 端点来识别组织的区域 API 访问点。
baseUris 端点仅通过 NA1 提供。即使组织托管在 EU1 中,也要调用 NA1 端点。
从响应中读取 apiAccessPoint 值。
响应标识分配给组织的区域 API 端点。
{
"apiAccessPoint": "[区域 Analyzer API 端点]"
}
使用返回的 apiAccessPoint 作为后续 Analyzer API 请求的基本 URL。
始终通过 baseUris 解析组织的 API 访问点,而不是硬编码区域端点。
验证 API 请求
在每个 API 请求的 Authorization 标头中传递 OAuth 服务器到服务器访问令牌:
Authorization: Bearer <access_token>
使用 baseUris 返回的 apiAccessPoint 构建后续 API 请求。
使用 API 参考
Analyzer 提供区域 Swagger 接口,用于探索端点、参数、请求和响应架构以及支持的操作。
使用组织所在区域的 Swagger 接口:
- NA1: https://analyzer-na1.adobe.io/swagger-ui/index.html
- EU1: https://analyzer-eu1.adobe.io/swagger-ui/index.html
在测试经过身份验证的端点之前,使用有效的 OAuth 服务器到服务器访问令牌对 Swagger 会话进行授权。
可用的 API 操作
使用 Analyzer API 可以:
- 上传文档进行处理。
- 搜索和筛选文档。
- 获取文档处理状态。
- 检索可用属性。
- 检索提取的属性值。
请参阅对应区域的 Swagger 界面,查看端点路径、参数、请求架构、响应架构和状态代码。
下一步
如果您的集成需要访问个体用户的 Analyzer 数据,请参阅在 Acrobat 中为 Analyzer 配置代理访问权限。