짧은 미디어 토큰 가져오기 obtain-short-media-token

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
Authentication

NOTE

이 페이지의 컨텐츠는 정보용으로만 제공됩니다. 이 API를 사용하려면 Adobe의 현재 라이선스가 필요합니다. 허가되지 않은 사용은 허용되지 않습니다.

NOTE

REST API 구현은 조절 메커니즘에 의해 제한됩니다.

REST API 끝점 clientless-endpoints

<레지스트리_FQDN>:

프로덕션 - api.auth.adobe.com
스테이징 - api.auth-staging.adobe.com

<SP_FQDN>:

프로덕션 - api.auth.adobe.com
스테이징 - api.auth-staging.adobe.com

설명 description

짧은 미디어 토큰을 가져옵니다.

엔드포인트

호출자:
명

입력
매개 변수

HTTP
메서드

응답

HTTP
응답

<SP_FQDN>/api/v1/mediatoken

또는

<SP_FQDN>/api/v1/tokens/media

예:

<SP_FQDN>/api/v1/tokens/media

스트리밍 앱

또는

프로그래머 서비스

1. 요청자(필수)
2. deviceId(필수)
3. 리소스(필수)
4. device_info/X-Device-Info(필수)
5. deviceType
6. deviceUser(사용하지 않음)
7. appId(더 이상 사용되지 않음)

GET

실패한 경우 Base64로 인코딩된 미디어 토큰 또는 오류 세부 정보가 포함된 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).

이 매개 변수가 올바르게 설정된 경우 Clientless를 사용할 때 ESM은 [장치 유형별로 분류된 지표]/(help/authentication/entitlement-service-monitoring-overview.md#clientless_device_type)를 제공하므로 다른 유형의 분석을 수행할 수 있습니다. 예를 들어 Roku, AppleTV 및 Xbox가 있습니다.

Clientless devicetype 매개 변수 사용의 이점🔗

참고 을 참조하세요. device_info가 이 매개 변수를 대체합니다.

deviceUser

장치 사용자 식별자.

참고: 사용하는 경우 deviceUser의 값은 등록 코드 만들기 요청과 동일해야 합니다.

appId

애플리케이션 ID/이름입니다.

참고: device_info가 이 매개 변수를 대체합니다. 사용하는 경우 appId은(는) 등록 코드 만들기 요청과 동일한 값을 가져야 합니다.

샘플 응답 response

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <play>
        <expires>1348649569000</expires>
        <mvpdId>sampleMvpdId</mvpdId>
        <requestor>sampleRequestorId</requestor>
        <resource>sampleResourceId</resource>
        <serializedToken>PHNpZ25hdH[...]</serializedToken>
        <userId>sampleScrambledUserId</userId>
    </play>

JSON:

    {
        "resource": "sampleResourceId",
        "requestor": "sampleRequestorId",
        "expires": "1348649614000",
        "serializedToken": "PHNpZ25hdH[...]",
        "userId": "sampleScrambledUserId",
        "mvpdId": "sampleMvpdId"
    }

Media Verification Library 호환성

"짧은 미디어 토큰 가져오기" 호출의 필드 serializedToken은(는) Adobe Medium 확인 라이브러리에 대해 확인할 수 있는 Base64로 인코딩된 토큰입니다.

recommendation-more-help

3f5e655c-af63-48cc-9769-2b6803cc5f4b