등록 페이지 registration-page

Last update: Wed Oct 23 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
Authentication

REST API 끝점 clientless-endpoints

NOTE

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

NOTE

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

<레지스트리_FQDN>:

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

<SP_FQDN>:

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

설명 create-reg-code-svc

임의로 생성된 등록 코드 및 로그인 페이지 URI를 반환합니다.

엔드포인트

호출자:
명

입력
매개 변수

HTTP
메서드

응답

HTTP
응답

<REGGIE_FQDN>/reggie/v1/{requestor}/regcode
예:
REGGIE_FQDN/reggie/v1/sampleRequestorId/regcode

스트리밍 앱
또는
프로그래머 서비스

1. 요청자
(경로 구성 요소)
2. deviceId(해시됨)
(필수)
3. device_info/X-Device-Info(필수)
4. mvpd(선택 사항)
5. ttl(선택 사항)

POST

실패한 경우 등록 코드 및 정보 또는 오류 세부 정보가 포함된 XML 또는 JSON. 아래 샘플을 참조하십시오.

201

입력 매개 변수

유형

설명

인증

헤더
값: 전달자 <access_token>

DCR 액세스 토큰

헤더
값: application/json

클라이언트가 이해할 수 있는 콘텐츠 유형 표시

요청자

쿼리 매개 변수

이 작업이 유효한 Programmer requestorId입니다.

deviceId

쿼리 매개 변수

장치 ID 바이트입니다.

device_info/
X-Device-Info

device_info: 본문
X-Device-Info: 헤더

스트리밍 장치 정보입니다.
참고: 이 매개 변수는 URL 매개 변수로 device_info를 전달할 수 있지만, 이 매개 변수의 잠재적 크기와 GET URL 길이 제한으로 인해 http 헤더에 X-Device-Info로 전달해야 합니다.
자세한 내용은 장치 및 연결 정보 전달을 참조하세요.

mvpd

쿼리 매개 변수

이 작업이 유효한 MVPD ID.

ttl

쿼리 매개 변수

이 regcode가 유지되어야 하는 시간(초)입니다.
참고: ttl에 허용되는 최대값은 36000초(10시간)입니다. 값이 높을수록 400 HTTP 응답(잘못된 요청)이 발생합니다. ttl을(를) 비워 두면 Adobe Pass 인증은 기본값으로 30분을 설정합니다.

deviceType

쿼리 매개 변수

사용 중단됨. 사용해서는 안 됩니다.

deviceUser

쿼리 매개 변수

사용 중단됨. 사용해서는 안 됩니다.

appId

쿼리 매개 변수

사용 중단됨. 사용해서는 안 됩니다.

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<br>X-Forwarded-For:203.45.101.20`

응답 JSON

등록 코드 JSON 샘플

{
  "id": "ef5a79e8-7c8a-41d6-a45a-e378c6c7c8b5",
  "code": "IYQD5JQ",
  "requestor": "sampleRequestorId",
  "mvpd": "sampleMvpdId",
  "generated": 1704963921144,
  "expires": 1704965721144,
  "info": {
    "deviceId": "c28tZGV2aWQtMDAz",
    "deviceInfo": "eyJ0eXBlIjoiU2V0VG9wQm94IiwibW9kZWwiOiJBRlRNTSIsInZlcnNpb24iOnsibWFqb3IiOjAsIm1pbm9yIjowLCJwYXRjaCI6MCwicHJvZmlsZSI6IiJ9LCJoYXJkd2FyZSI6eyJuYW1lIjoiQUZUTU0iLCJ2ZW5kb3IiOiJVbmtub3duIiwidmVyc2lvbiI6eyJtYWpvciI6MCwibWlub3IiOjAsInBhdGNoIjowLCJwcm9maWxlIjoiIn0sIm1hbnVmYWN0dXJlciI6IlJva3UifSwib3BlcmF0aW5nU3lzdGVtIjp7Im5hbWUiOiJBbmRyb2lkIiwiZmFtaWx5IjoiQW5kcm9pZCIsInZlbmRvciI6IkFtYXpvbiIsInZlcnNpb24iOnsibWFqb3IiOjcsIm1pbm9yIjoxLCJwYXRjaCI6MiwicHJvZmlsZSI6IiJ9fSwiYnJvd3NlciI6eyJuYW1lIjoiQ2hyb21lIiwidmVuZG9yIjoiR29vZ2xlIiwidmVyc2lvbiI6eyJtYWpvciI6MTEyLCJtaW5vciI6MCwicGF0Y2giOjU2MTUsInByb2ZpbGUiOiIifSwidXNlckFnZW50IjoiTW96aWxsYS81LjAgKExpbnV4OyBBbmRyb2lkIDcuMS4yOyBBRlRNTSBCdWlsZC9OUzYyOTc7IHd2KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBWZXJzaW9uLzQuMCBDaHJvbWUvMTEyLjAuNTYxNS4xOTcgTW9iaWxlIFNhZmFyaS81MzcuMzYgQWRvYmVQYXNzTmF0aXZlRmlyZVRWLzMuMC44Iiwib3JpZ2luYWxVc2VyQWdlbnQiOiJNb3ppbGxhLzUuMCAoTGludXg7IEFuZHJvaWQgNy4xLjI7IEFGVE1NIEJ1aWxkL05TNjI5Nzsgd3YpIEFwcGxlV2ViS2l0LzUzNy4zNiAoS0hUTUwsIGxpa2UgR2Vja28pIFZlcnNpb24vNC4wIENocm9tZS8xMTIuMC41NjE1LjE5NyBNb2JpbGUgU2FmYXJpLzUzNy4zNiBBZG9iZVBhc3NOYXRpdmVGaXJlVFYvMy4wLjgifSwiZGlzcGxheSI6eyJ3aWR0aCI6MCwiaGVpZ2h0IjowLCJwcGkiOjAsIm5hbWUiOiJESVNQTEFZIiwidmVuZG9yIjpudWxsLCJ2ZXJzaW9uIjpudWxsLCJkaWFnb25hbFNpemUiOm51bGx9LCJhcHBsaWNhdGlvbklkIjpudWxsLCJjb25uZWN0aW9uIjp7ImlwQWRkcmVzcyI6IjE5My4xMDUuMTQwLjEzMSIsInBvcnQiOiI5OTM0Iiwic2VjdXJlIjpmYWxzZSwidHlwZSI6bnVsbH19",
    "userAgent": "Mozilla/5.0 (Linux; Android 7.1.2; AFTMM Build/NS6297; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/112.0.5615.197 Mobile Safari/537.36 AdobePassNativeFireTV/3.0.8",
    "originalUserAgent": "Mozilla/5.0 (Linux; Android 7.1.2; AFTMM Build/NS6297; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/112.0.5615.197 Mobile Safari/537.36 AdobePassNativeFireTV/3.0.8",
    "authorizationType": "OAUTH2",
    "sourceApplicationInformation": {
      "id": "14138364-application-id",
      "name": "application name",
      "version": "1.0.0"
    }
  }
}

요소 이름

설명

등록 코드 서비스에서 생성된 UUID

코드

등록 코드 서비스에서 생성한 등록 코드

요청자

요청자 ID

mvpd

Mvpd ID

생성됨

등록 코드 생성 타임스탬프(1970년 1월 1일 GMT 이후 밀리초)

만료

등록 코드가 만료되는 타임스탬프(1970년 1월 1일 GMT 이후 밀리초)

deviceId

Base64 고유 장치 ID

info:deviceId

Base64 장치 유형

info:deviceInfo

Base64 User-Agent, X-Device-Info 또는 device_info에서 받은 정보를 기반으로 표준화된 장치 정보 작성

info:userAgent

애플리케이션에서 보낸 사용자 에이전트

info:originalUserAgent

애플리케이션에서 보낸 사용자 에이전트

info:authorizationType

DCR을 사용한 호출에 대한 OAUTH2

info:sourceApplicationInformation

DCR에 구성된 애플리케이션 정보

오류 메시지 JSON 응답 샘플(#error-sample-response)

{
  "status": 400,
  "message": "Required '<>' is not present"
}

recommendation-more-help

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