Acrobat에서 Analyzer로 API 요청하기

마지막 업데이트 날짜 2026년 10월 28일

조직의 지역 API 엔드포인트를 확인하고, 요청을 인증하며, Acrobat API의 Analyzer를 사용하세요.

Analyzer API를 호출하기 전에 조직의 API 액세스 포인트를 확인하세요. Analyzer는 현재 NA1 및 EU1 지역을 지원합니다.

시작하기 전에

Acrobat에서 Analyzer용 API 액세스 설정을 완료하고 유효한 OAuth Server-to-Server 액세스 토큰을 준비하세요.

지역 API 엔드포인트 확인

Analyzer는 baseUris 엔드포인트를 사용하여 조직의 지역 API 액세스 포인트를 식별합니다.

baseUris 엔드포인트는 NA1을 통해서만 사용할 수 있습니다. 조직이 EU1에서 호스팅되는 경우에도 NA1 엔드포인트를 호출하세요.

Analyzer baseUris 엔드포인트에 인증된 GET 요청을 보내세요:

응답에서 apiAccessPoint 값을 읽으세요.

응답은 조직에 할당된 지역 API 엔드포인트를 식별합니다.

{
"apiAccessPoint": "[regional Analyzer API endpoint]"
}

반환된 apiAccessPoint를 후속 Analyzer API 요청의 기본 URL로 사용하세요.

지역 엔드포인트를 하드코딩하지 말고 항상 baseUris를 통해 조직의 API 액세스 포인트를 확인하세요.

API 요청 인증

각 API 요청에 대해 Authorization 헤더에 OAuth Server-to-Server 액세스 토큰을 전달하세요:

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 Server-to-Server 액세스 토큰으로 Swagger 세션을 인증하세요.

사용 가능한 API 작업

Analyzer API를 사용하여 다음을 수행하세요:

  • 처리할 문서를 업로드하세요.
  • 문서를 검색하고 필터링하세요.
  • 문서 처리 상태 가져오기
  • 사용 가능한 속성을 가져오세요.
  • 추출된 속성 값을 검색하세요.

엔드포인트 경로, 매개변수, 요청 스키마, 응답 스키마, 상태 코드에 대한 자세한 내용은 지역별 Swagger 인터페이스를 참조하세요.

다음 단계

통합에서 개인 사용자의 Analyzer 데이터에 액세스해야 하는 경우 Acrobat에서 Analyzer의 대리 액세스 구성을 참조하세요.