설명서Adobe PassAdobe Pass 인증

인증 시작 initiate-authorization

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

REST API 끝점 clientless-endpoints

<레지스트리_FQDN>:

<SP_FQDN>:

설명 description

인증 응답을 가져옵니다.

엔드포인트
호출자:
명
입력
매개 변수
HTTP
메서드
응답
HTTP
응답
<SP_FQDN>/api/v1/권한 부여
스트리밍 앱

또는

프로그래머 서비스
1. 요청자(필수)
2. deviceId(필수)
3. 리소스(필수)
4. device_info/X-Device-Info(필수)
5. deviceType
6. deviceUser(사용하지 않음)
7. appId(사용하지 않음)
8. 추가 매개 변수(선택 사항)
GET
실패한 경우 인증 세부 정보 또는 오류 세부 정보가 포함된 XML 또는 JSON입니다. 아래 샘플을 참조하십시오.
200 - 성공
403 - 성공 없음
입력 매개 변수
설명
요청자
이 작업이 유효한 Programmer requestorId입니다.
deviceId
장치 ID 바이트입니다.
리소스
resourceId(또는 MRSS 조각)가 포함된 문자열은 사용자가 요청한 콘텐츠를 식별하며 MVPD 인증 종단점에서 인식됩니다.
device_info/

X-Device-Info
스트리밍 장치 정보입니다.

참고: 이 매개 변수는 URL 매개 변수로 device_info를 전달할 수 있지만, 이 매개 변수의 잠재적 크기와 GET URL 길이 제한으로 인해 http 헤더에 X-Device-Info로 전달해야 합니다.

자세한 내용은 장치 및 연결 정보 전달을 참조하세요.
deviceType
디바이스 유형(예: Roku, PC).

이 매개 변수가 올바르게 설정된 경우 ESM은 Clientless를 사용할 때 장치 유형별로 분류된 지표를 제공하므로 Roku, AppleTV, Xbox 등의 다양한 분석 유형을 수행할 수 있습니다.

전달 지표에서 클라이언트 없는 장치 유형 매개 변수의 이점참조​

참고: device_info가 이 매개 변수를 대체합니다.
deviceUser
장치 사용자 식별자.
appId
애플리케이션 ID/이름입니다.

참고: device_info가 이 매개 변수를 대체합니다.
추가 매개 변수
호출에는

* generic_data - 프로모션 TempPass

와(과) 같은 다른 기능을 활성화하는 선택적 매개 변수도 포함될 수 있습니다. 예: generic_data=("email":"email@domain.com")
CAUTION
스트리밍 장치 IP 주소

클라이언트-서버 구현의 경우 스트리밍 장치 IP 주소는 이 호출과 함께 암시적으로 전송됩니다. regcode 호출이 스트리밍 장치가 아닌 프로그래머 서비스에서 수행되는 서버 간 구현의 경우 스트리밍 장치 IP 주소를 전달하려면 다음 헤더가 필요합니다.
code language-none 
X-Forwarded-For : <streaming\_device\_ip>
여기서 <streaming\_device\_ip>은(는) 스트리밍 장치 공용 IP 주소입니다.


예:
code language-none 
POST /reggie/v1/{req_id}/regcode HTTP/1.1
X-Forwarded-For:203.45.101.20

샘플 응답 sample-response

  • 사례 1: 성공

    • XML:

    "XML
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <authorization>
    <expires>1348148289000</expires>
    <mvpd>sampleMvpdId</mvpd>
    <requestor>sampleRequestorId</requestor>
    <resource>sampleResourceId</resource>
    </authorization>
    "

  • JSON:

    code language-json 
    {
  "mvpd": "sampleMvpdId",
  "resource": "sampleResourceId",
  "requestor": "sampleRequestorId",
  "expires": "1348148289000"
}
IMPORTANT
프록시 MVPD에서 응답이 오는 경우 proxyMvpd(이)라는 추가 요소가 포함될 수 있습니다.

  • 사례 2: 권한 부여가 거부됨

    code language-json 
    <error>
  <status>403</status>
  <message>User not authorized</message>
  <details>Your subscription package does not include the "ASFAFD" channel.
  Please go to http://www.ca.ble/upgrade in order to upgrade your subscription.</details>
</error>
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b