Knowledge Base API 액세스 설정

기술 자료 API를 테스트하거나 애플리케이션을 연결하는 데 필요한 인증을 구성합니다.

기술 자료 API 요청에는 베어러 토큰 인증이 사용됩니다. 단기 테스트에는 인증된 사용자 토큰을 사용하고, 애플리케이션 또는 통합을 위해서는 기술 계정을 구성하세요.

시작하기 전에

다음 사항을 확인하세요:

• 조직에서 기술 자료에 액세스할 수 있습니다.
• 워크플로에 필요한 API 리소스에 액세스할 수 있습니다.
• 애플리케이션 통합을 설정하는 경우 Adobe Developer Console에 액세스할 수 있습니다.

API 액세스는 기술 자료 권한을 재정의하지 않습니다. 인증된 ID는 애플리케이션에서 요청하는 컬렉션, 문서 및 작업에 액세스할 수 있어야 합니다.

인증 방법 선택

개발 단계에 맞는 인증 방법을 사용하세요.

사용자 베어러 토큰

인증된 사용자 베어러 토큰은 API 참조를 통해 수행하는 요청을 포함해 API 요청을 테스트하는 데 유용합니다.

토큰은 로그인한 사용자를 나타내며 24시간 동안 유효합니다. 토큰으로 요청하면 해당 사용자가 사용할 수 있는 것과 동일한 기술 자료 액세스 권한이 제공됩니다.

사용자 베어러 토큰을 획득한 후 각 요청에 포함하세요.

Authorization: Bearer <access-token>

또한 토큰을 대화형 기술 자료 API 참조와 함께 사용하여 사용 가능한 엔드포인트를 테스트할 수 있습니다.

이미 액세스 권한이 있는 리소스를 검색하는 작업부터 시작하세요. 성공적인 응답은 토큰이 수락되고 인증된 ID가 해당 리소스에 액세스할 수 있음을 확인합니다.

기술 자료 API 참조 열기

기술 계정

대화형 사용자 세션 없이 인증해야 하는 애플리케이션 및 통합에는 기술 계정을 사용하세요.

기술 계정은 Adobe Developer Console을 통해 구성됩니다. 기술 계정 설정 프로세스에 따라 애플리케이션에 필요한 자격 증명을 생성하세요.

기술 계정 만들기

기술 계정을 생성한 후 이 페이지로 돌아와 Knowledge Base API에 대한 액세스 권한을 확인합니다.

API 권한 이해하기

인증은 API 요청을 하는 ID를 확인합니다. 인증은 해당 ID가 수행할 수 있는 작업을 결정합니다.

예를 들어, 인증된 ID가 특정 컬렉션은 가져올 수 있지만 다른 컬렉션은 가져올 수 없거나, 관리자 수준 리소스에 액세스할 수 없을 수도 있습니다.

인증에 성공했지만 작업이 거부된 경우, 응답을 인증 실패로 간주하기 전에 인증된 ID에 요청된 리소스에 액세스할 권한이 있는지 확인하세요.

API 액세스 검증하기

인증이 구성된 후:

1. 액세스 토큰 획득
2. 인증된 ID가 액세스할 수 있는 리소스에 요청을 제출하세요.
3. API가 예상된 응답을 반환하는지 확인하세요.
4. API 시작 워크플로를 계속 진행하세요.

Knowledge Base API 시작