시작하기 REST APIs getting-started-with-rest-apis

Adobe Developer 개요 adobeio

Adobe Developer 는 Adobe의 개발자 생태계 및 커뮤니티입니다. 여기에는 다음이 포함됩니다 모든 Adobe 제품에 대한 API.

다음은 설정 및 사용에 권장되는 방법입니다 Adobe APIs.

전제 조건 prerequisites

을(를) 구성하기 전에 JWT 인증, 다음에 대한 액세스 권한이 있는지 확인하십시오. Adobe Developer 콘솔 위치: Adobe Developer. 액세스 요청에 대해서는 조직 관리자에게 문의하십시오.

인증 auth

아래 단계에 따라 구성하십시오. JWT (Service Account) 을 사용한 인증 Adobe Developer:

1. 에 로그인합니다 Adobe Developer 콘솔.
2. 의 단계를 따릅니다. 서비스 계정 연결.
   • 다음 기간 동안 2단계: 서비스 계정 인증을 사용하여 프로젝트에 API 추가, 을(를) 선택합니다. Audience Manager API 옵션을 선택합니다.
3. 첫 번째 를 만들어 연결 시도 API 의 지침에 따라 를 호출합니다. 3단계.

기술 계정 RBAC 권한

Audience Manager 계정에서 역할 기반 액세스 제어, Audience Manager 기술 사용자 계정을 만든 다음 API를 호출할 Audience Manager RBAC 그룹에 추가해야 합니다.

아래 단계에 따라 기술 사용자 계정을 만들고 RBAC 그룹에 추가합니다.

1. 만들기 GET 호출 대상 https://aam.adobe.io/v1/users/self. 호출은에서 볼 수 있는 기술 사용자 계정을 만듭니다. Admin Console, Users 페이지를 가리키도록 업데이트하는 중입니다.

   

2. Audience Manager 계정에 로그인하고 기술 사용자 계정 추가 API를 호출할 사용자 그룹에 연결합니다.

다음 Audience Manager REST API 팔로우 OAuth 2.0 토큰 인증 및 갱신에 대한 표준. 아래 섹션에서는 를 인증하고 작업을 시작하는 방법에 대해 설명합니다. APIs.

일반 만들기 API 사용자 requirements

을 사용하여 작업할 별도의 기술 사용자 계정을 만드는 것이 좋습니다. Audience Manager APIs. 조직의 특정 사용자와 연결되거나 연결되지 않은 일반 계정입니다. 이 유형의 API 사용자 계정은 다음 두 가지 작업을 수행하는 데 도움이 됩니다.

• 어떤 서비스가 를 호출하는지 확인합니다. API (예: 를 사용하는 앱에서의 호출 API또는 다음을 만드는 다른 도구에서 API 요청)을 참조하십시오.
• 에 중단 없이 액세스 제공 APIs. 특정 사용자에 연결된 계정은 회사에서 나갈 때 삭제될 수 있습니다. 이렇게 하면 사용 가능한 로 작업할 수 없습니다. API 코드. 특정 직원에게 연결되지 않은 일반 계정은 이 문제를 방지하는 데 도움이 됩니다.

이 유형의 계정에 대한 사용 사례로서, 을 사용하여 한 번에 많은 세그먼트를 변경한다고 가정해 보겠습니다. 벌크 관리 도구. 이렇게 하려면 사용자 계정이 필요합니다. API 액세스 권한. 특정 사용자에게 권한을 추가하는 대신 비특정 API 적절한 자격 증명, 키 및 암호가 있는 사용자 계정 API 호출. 이 기능은 를 사용하는 자체 애플리케이션을 개발하는 경우에도 유용합니다 Audience Manager APIs.

을(를) 사용하여 작업 Audience Manager 컨설턴트가 제네릭을 설정하는 경우, API-전용 사용자 계정.

암호 인증 워크플로 password-authentication-workflow

암호 인증 보안 액세스 REST API. 아래 단계에서는 의 암호 인증 워크플로에 대해 간략하게 설명합니다. JSON 클라이언트 를 사용할 수 있습니다.

1단계: 요청 API 액세스

파트너 솔루션 관리자에게 문의하십시오. 방문자는 사용자에게 다음을 제공합니다. API 클라이언트 ID 및 암호. ID 및 비밀로 다음을 인증합니다. API.

참고: 새로 고침 토큰을 받으려면 요청할 때 을 지정하십시오 API 액세스 권한.

2단계: 토큰 요청

원하는 토큰 요청을 전달합니다. JSON 클라이언트. 요청을 빌드할 때:

• 사용 POST 호출할 메서드 https://api.demdex.com/oauth/token.
• 클라이언트 ID 및 암호를 base-64로 인코딩된 문자열로 변환합니다. 전환 프로세스 중에 콜론으로 ID와 암호를 구분합니다. 예를 들어 자격 증명은 testId : testSecret 변환 대상 dGVzdElkOnRlc3RTZWNyZXQ=.
• 전달 HTTP headers Authorization:Basic <base-64 clientID:clientSecret> 및 Content-Type: application/x-www-form-urlencoded . 예를 들어 머리글은 다음과 같습니다.
  Authorization: Basic dGVzdElkOnRlc3RTZWNyZXQ=
Content-Type: application/x-www-form-urlencoded
• 요청 본문을 다음과 같이 설정합니다.
  
  grant_type=password&username=<your-AudienceManager-user-name>&password=<your-AudienceManager-password>

3단계: 토큰 받기

다음 JSON 응답에 액세스 토큰이 포함되어 있습니다. 응답은 다음과 같아야 합니다.

{
    "access_token": "28fed402-eafd-456c-9341-ac753f25bbbc",
    "token_type": "bearer",
    "refresh_token": "b27122c0-b0c7-4b39-a71b-1547a3b3b88e",
    "expires_in": 21922,
    "scope": "read write"
}

다음 expires_in key는 액세스 토큰이 만료될 때까지의 시간(초)을 나타냅니다. 토큰이 노출된 경우 짧은 만료 시간을 사용하여 노출을 제한하는 것이 좋습니다.

토큰 새로 고침 refresh-token

토큰 갱신 새로 고침 API 원래 토큰이 만료된 후에 액세스합니다. 요청한 경우 응답 JSON 암호 워크플로의 경우 새로 고침 토큰이 포함됩니다. 새로 고침 토큰을 받지 못한 경우 암호 인증 프로세스를 통해 새 토큰을 만듭니다.

기존 액세스 토큰이 만료되기 전에 새로 고침 토큰을 사용하여 새 토큰을 생성할 수도 있습니다.

액세스 토큰이 만료된 경우 다음을 받게 됩니다. 401 Status Code 응답에 포함된 다음 헤더:

WWW-Authenticate: Bearer realm="oauth", error="invalid_token", error_description="Access token expired: <token>"

다음 절차에서는 새로 고침 토큰을 사용하여 다음에서 새 액세스 토큰을 생성하기 위한 워크플로에 대해 설명합니다. JSON 클라이언트 를 사용할 수 있습니다.

1단계: 새 토큰 요청

원하는 토큰 을 사용하여 새로 고침 요청을 전달합니다. JSON 클라이언트. 요청을 빌드할 때:

• 사용 POST 호출할 메서드 https://api.demdex.com/oauth/token.
• 클라이언트 ID 및 암호를 base-64로 인코딩된 문자열로 변환합니다. 전환 프로세스 중에 콜론으로 ID와 암호를 구분합니다. 예를 들어 자격 증명은 testId : testSecret 변환 대상 dGVzdElkOnRlc3RTZWNyZXQ=.
• HTTP 헤더 전달 Authorization:Basic <base-64 clientID:clientSecret> 및 Content-Type: application/x-www-form-urlencoded. 예를 들어 머리글은 다음과 같습니다.
  Authorization: Basic dGVzdElkOnRlc3RTZWNyZXQ=
Content-Type: application/x-www-form-urlencoded
• 요청 본문에서 grant_type:refresh_token 이전 액세스 요청에서 받은 새로 고침 토큰을 전달합니다. 요청은 다음과 같아야 합니다.
  grant_type=refresh_token&refresh_token=b27122c0-b0c7-4b39-a71b-1547a3b3b88e

2단계: 새 토큰 받기

다음 JSON 응답에 새 액세스 토큰이 포함되어 있습니다. 응답은 다음과 같아야 합니다.

{
    "access_token": "4fdfc261-2ffc-4fb7-8dbd-64221714c45f",
    "token_type": "bearer",
    "refresh_token": "295fa487-1825-4caa-a715-80b81ac17dae",
    "expires_in": 21922,
    "scope": "read write"
}

인증 코드 및 암시적 인증 authentication-code-implicit

다음 Audience Manager REST API 는 인증 코드 및 암시적 인증을 지원합니다. 이러한 액세스 방법을 사용하려면 사용자가에 로그인해야 합니다. https://api.demdex.com/oauth/authorize 액세스 및 토큰 새로 고침.