설명서Adobe PassAdobe Pass 인증

특정 mvpd를 사용하여 사전 인증 결정 검색 retrieve-preauthorization-decisions-using-specific-mvpd

Last update: Tue Sep 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
이 페이지의 컨텐츠는 정보용으로만 제공됩니다. 이 API를 사용하려면 Adobe의 현재 라이선스가 필요합니다. 허가되지 않은 사용은 허용되지 않습니다.
IMPORTANT
REST API V2 구현은 조절 메커니즘 설명서에 의해 제한됩니다.

요청 request

HTTP
경로
/api/v2/{serviceProvider}/decisions/preauthorize/{mvpd}
방법
POST
경로 매개 변수
serviceProvider
온보딩 프로세스 중 서비스 공급자와 연결된 내부 고유 식별자입니다.
필수
mvpd
온보딩 프로세스 중 ID 공급자와 연결된 내부 고유 식별자입니다.
필수
본문 매개 변수
리소스
표시되기 전에 MVPD 결정이 필요한 리소스 목록입니다.
필수
헤더
인증
전달자 토큰 페이로드의 생성은 인증 헤더 설명서에 설명되어 있습니다.
필수
Content-Type
전송 중인 리소스에 대해 허용되는 미디어 유형입니다.

application/json이어야 합니다.
필수
AP-Device-Identifier
장치 식별자 페이로드 생성은 AP-Device-Identifier 헤더 문서에 설명되어 있습니다.
필수
X-Device-Info
장치 정보 페이로드의 생성은 X-Device-Info 헤더 설명서에 설명되어 있습니다.

응용 프로그램의 장치 플랫폼에서 유효한 값의 명시적 제공을 허용하는 경우 항상 사용하는 것이 좋습니다.

제공되면 Adobe Pass 인증 백엔드는 명시적으로 설정된 값을 추출된 값과 묵시적으로(기본적으로) 병합합니다.

제공하지 않으면 Adobe Pass 인증 백엔드는 추출된 값을 묵시적으로(기본적으로) 사용합니다.
필수
X-Forwarded-For
스트리밍 장치의 IP 주소입니다.

특히 스트리밍 장치가 아닌 프로그래머 서비스에서 호출하는 경우 항상 서버 대 서버 구현에 사용하는 것이 좋습니다.

클라이언트 대 서버 구현의 경우, 스트리밍 장치의 IP 주소가 암묵적으로 전송됩니다.
선택 사항
Adobe-Subject-Token
or
X-Roku-Reserved-Roku-Connect-Token
플랫폼 ID 메서드에 대한 Single Sign-On 페이로드 생성은 Adobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token 헤더 설명서에 설명되어 있습니다.

플랫폼 ID를 사용한 Single Sign-On 사용 흐름에 대한 자세한 내용은 플랫폼 ID 흐름을 사용한 Single Sign-On 설명서를 참조하십시오.
선택 사항
광고 서비스 토큰
서비스 토큰 메서드에 대한 Single Sign-On 페이로드의 생성은 AD-Service-Token 헤더 설명서에 설명되어 있습니다.

서비스 토큰을 사용한 Single Sign-On 사용 흐름에 대한 자세한 내용은 서비스 토큰 흐름을 사용한 Single Sign-On 설명서를 참조하십시오.
선택 사항
AP-Partner-Framework-Status
Partner 메서드에 대한 SSO(Single Sign-On) 페이로드의 생성은 AP-Partner-Framework-Status 헤더 문서에 설명되어 있습니다.

파트너를 사용한 Single Sign-On 사용 흐름에 대한 자세한 내용은 파트너 흐름을 사용한 Single Sign-On 설명서를 참조하십시오.
선택 사항
AP-Visitor-Identifier
방문자 식별자 페이로드 생성은 AP-Visitor-Identifier 헤더 문서에 설명되어 있습니다.
선택 사항
Accept
클라이언트 애플리케이션에서 허용하는 미디어 유형입니다.

지정하면 application/json이어야 합니다.
선택 사항
User-Agent
클라이언트 애플리케이션의 사용자 에이전트입니다.
선택 사항

응답 response

코드
텍스트
설명
200
확인
응답 본문에는 추가 정보가 있는 결정 목록이 포함되어 있습니다.
400
잘못된 요청
요청이 잘못되었습니다. 클라이언트가 요청을 수정하고 다시 시도하십시오. 응답 본문에는 향상된 오류 코드 설명서를 준수하는 오류 정보가 포함될 수 있습니다.
401
승인되지 않음
액세스 토큰이 잘못되었습니다. 클라이언트가 새 액세스 토큰을 얻은 후 다시 시도하십시오. 자세한 내용은 동적 클라이언트 등록 개요 설명서를 참조하십시오.
405
메서드가 허용되지 않음
HTTP 메서드가 잘못되었습니다. 클라이언트가 요청한 리소스에 대해 허용되는 HTTP 메서드를 사용하고 다시 시도하십시오. 자세한 내용은 요청 섹션을 참조하세요.
500
내부 서버 오류
서버 측에서 문제가 발생했습니다. 응답 본문에는 향상된 오류 코드 설명서를 준수하는 오류 정보가 포함될 수 있습니다.

성공 success

헤더
상태
200
필수
Content-Type
application/json
필수
본문
결정

각 요소에 다음 속성이 있는 요소 목록이 포함된 JSON:

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 1-bgcolor-eff2f7 2-bgcolor-eff2f7 3-bgcolor-eff2f7 5-bgcolor-deebff 9-bgcolor-deebff 13-bgcolor-deebff 17-bgcolor-deebff 21-bgcolor-deebff 25-bgcolor-deebff layout-auto html-authored
속성
리소스 사전 인증 결정이 반환되는 리소스 식별자입니다. 필수
serviceProvider 온보딩 프로세스 중 서비스 공급자와 연결된 내부 고유 식별자입니다. 필수
mvpd 온보딩 프로세스 중 ID 공급자와 연결된 내부 고유 식별자입니다. 필수
authorized 'true' 또는 'false'일 수 있는 리소스의 결정 상태. 필수
소스

의사 결정 소스에 대한 정보:

가능한 값은 다음과 같습니다.

  • MVPD 사전 인증 끝점에서 mvpd
    결정을 내렸습니다.
  • 액세스 성능이 저하되어 성능 저하
    결정이 내려졌습니다.
  • temppass
    임시 액세스의 결과로 결정이 내려졌습니다.
  • dummy
    더미 사전 인증 기능의 결과로 결정이 내려졌습니다.
 필수
오류 오류는 향상된 오류 코드 설명서를 준수하는 '거부' 결정에 대한 추가 정보를 제공합니다. 선택 사항
필수

오류 error

헤더
상태
400, 401, 405, 500
필수
Content-Type
application/json
필수
본문

응답 본문은 향상된 오류 코드 설명서를 준수하는 추가 오류 정보를 제공할 수 있습니다.

클라이언트 애플리케이션은 이 API에서 가장 일반적으로 반환되는 오류 코드를 제대로 처리할 수 있는 오류 처리 메커니즘을 구현해야 합니다.

  • authenticated_profile_missing
  • authenticated_profile_expired
  • preauthorization_denied_by_mvpd
  • network_received_error
  • too_many_resource
  • 등

위의 목록은 완전하지 않습니다. 클라이언트 응용 프로그램은 공개 설명서에 정의된 모든 향상된 오류 코드를 처리할 수 있어야 합니다.

필수

샘플 samples

​1. 특정 mvpd를 사용하여 사전 인증 결정 검색

요청
code language-https 
POST /api/v2/REF30/decisions/preauthorize/Cablevision HTTP/1.1

    Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJjNGZjM2U3ZS0xMmQ5LTQ5NWQtYjc0Mi02YWVhYzhhNDkwZTciLCJuYmYiOjE3MjQwODc4NjgsImlzcyI6ImF1dGguYWRvYmUuY29tIiwic2NvcGVzIjoiYXBpOmNsaWVudDp2MiIsImV4cCI6MTcyNDEwOTQ2OCwiaWF0IjoxNzI0MDg3ODY4fQ.DJ9GFl_yKAp2Qw-NVcBeRSnxIhqrwxhns5T5jU31N2tiHxCucKLSQ5guBygqkkJx6D0N_93f50meEEyfb7frbHhVHHwmRjHYjkfrWqHCpviwVjVZKKwl8Y3FEMb0bjKIB8p_E3txX9IbzeNGWRufZBRh2sxB5Q9B7XYINpVfh8s_sFvskrbDu5c01neCx5kEagEW5CtE0_EXTgEb5FSr_SfQG3UUu_iwlkOggOh_kOP_5GueElf9jn-bYBMnpObyN5s-FzuHDG5Rtac5rvcWqVW2reEqFTHqLI4rVC7UKQb6DSvPBPV4AgrutAvk30CYgDsOQILVyrjniincp7r9Ww
    Content-Type: application/json
    AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
    X-Device-Info: ewoJInByaW1hcnlIYXJkd2FyZVR5cGUiOiAiU2V0VG9wQm94IiwKCSJtb2RlbCI6ICJUViA1dGggR2VuIiwKCSJtYW51ZmFjdHVyZXIiOiAiQXBwbGUiLAoJIm9zTmFtZSI6ICJ0dk9TIgoJIm9zVmVuZG9yIjogIkFwcGxlIiwKCSJvc1ZlcnNpb24iOiAiMTEuMCIKfQ==
    Accept: application/json
    User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)

Body:

{
    "resources": ["resource1", "resource2", "resource3"]
}
응답
code language-https 
HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

{
   "decisions": [
      {
         "resource": "resource1 ",
         "serviceProvider": "REF30",
         "mvpd": "Cablevision",
         "source": "mvpd",
         "authorized": true
      },
      {
         "resource": "resource2",
         "serviceProvider": "REF30",
         "mvpd": "Cablevision",
         "source": "mvpd",
         "authorized": true
      },
      {
         "resource": "resource3",
         "serviceProvider": "REF30",
         "mvpd": "Cablevision",
         "source": "mvpd",
         "authorized": false,
         "error": {
            "status": 403,
            "code": "preauthorization_denied_by_mvpd",
            "message": "The MVPD has returned a \"Deny\" decision when requesting pre-authorization for the specified resource.",
            "helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=ko",
            "action": "none"
         }
      }
   ]
}

​2. 성능 저하를 적용하는 동안 특정 mvpd를 사용하여 사전 인증 결정을 검색합니다.

요청
code language-https 
POST /api/v2/REF30/decisions/preauthorize/${degradedMvpd} HTTP/1.1

    Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJjNGZjM2U3ZS0xMmQ5LTQ5NWQtYjc0Mi02YWVhYzhhNDkwZTciLCJuYmYiOjE3MjQwODc4NjgsImlzcyI6ImF1dGguYWRvYmUuY29tIiwic2NvcGVzIjoiYXBpOmNsaWVudDp2MiIsImV4cCI6MTcyNDEwOTQ2OCwiaWF0IjoxNzI0MDg3ODY4fQ.DJ9GFl_yKAp2Qw-NVcBeRSnxIhqrwxhns5T5jU31N2tiHxCucKLSQ5guBygqkkJx6D0N_93f50meEEyfb7frbHhVHHwmRjHYjkfrWqHCpviwVjVZKKwl8Y3FEMb0bjKIB8p_E3txX9IbzeNGWRufZBRh2sxB5Q9B7XYINpVfh8s_sFvskrbDu5c01neCx5kEagEW5CtE0_EXTgEb5FSr_SfQG3UUu_iwlkOggOh_kOP_5GueElf9jn-bYBMnpObyN5s-FzuHDG5Rtac5rvcWqVW2reEqFTHqLI4rVC7UKQb6DSvPBPV4AgrutAvk30CYgDsOQILVyrjniincp7r9Ww
    Content-Type: application/json
    AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
    X-Device-Info: ewoJInByaW1hcnlIYXJkd2FyZVR5cGUiOiAiU2V0VG9wQm94IiwKCSJtb2RlbCI6ICJUViA1dGggR2VuIiwKCSJtYW51ZmFjdHVyZXIiOiAiQXBwbGUiLAoJIm9zTmFtZSI6ICJ0dk9TIgoJIm9zVmVuZG9yIjogIkFwcGxlIiwKCSJvc1ZlcnNpb24iOiAiMTEuMCIKfQ==
    Accept: application/json
    User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)

Body:

{
    "resources": ["REF30", "apasstest1"]
}
응답 - AuthNaLl 저하
code language-https 
HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

{
    "decisions": [
        {
            "resource": "REF30",
            "serviceProvider": "REF30",
            "mvpd": "${degradedMvpd}",
            "source": "degradation",
            "authorized": true
        }
        {
            "resource": "apasstest1",
            "serviceProvider": "REF30",
            "mvpd": "${degradedMvpd}",
            "source": "degradation",
            "authorized": true
        }
    ]
}
응답 - AuthZaLl 성능 저하
code language-https 
HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

{
    "decisions": [
        {
            "resource": "REF30",
            "serviceProvider": "REF30",
            "mvpd": "${degradedMvpd}",
            "source": "degradation",
            "authorized": true
        }
        {
            "resource": "apasstest1",
            "serviceProvider": "REF30",
            "mvpd": "${degradedMvpd}",
            "source": "degradation",
            "authorized": true
        }
    ]
}
응답 - AuthZNone 저하
code language-https 
HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

{
    "decisions": [
        {
            "resource": "REF30",
            "serviceProvider": "REF30",
            "mvpd": "${degradedMvpd}",
            "source": "degradation",
            "authorized": false,
            "error": {
                "status": 403,
                "code": "authorization_denied_by_degradation_rule",
                "message": "The integration has an AuthZNone rule applied for the requested resources",
                "helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=ko",
                "action": "none"
            }
        }
        {
            "resource": "apasstest1",
            "serviceProvider": "REF30",
            "mvpd": "${degradedMvpd}",
            "source": "degradation",
            "authorized": false,
            "error": {
                "status": 403,
                "code": "authorization_denied_by_degradation_rule",
                "message": "The integration has an AuthZNone rule applied for the requested resources",
                "helpUrl": "https://experienceleague.adobe.com/docs/pass/authentication/auth-features/error-reportn/enhanced-error-codes.html?lang=ko",
                "action": "none"
            }
        }
    ]
}
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b