TMDB(The Movie Database) API 키 신청 방법

TMDB 소개

TMDB(The Movie Database)는 영화, TV 프로그램, 배우, 제작진에 대한 포괄적인 데이터를 제공하는 공개 영화 및 TV 데이터베이스입니다. 흔히 "영화 및 TV 업계의 위키피디아"로 불리는 TMDB는 사용자가 항목을 생성하고 편집하여 기여할 수 있도록 합니다. 영화 포스터, 요약 및 기타 메타데이터를 검색할 수 있는 공개 API를 제공합니다.

UGOS Pro의 "극장" 애플리케이션은 TMDB를 데이터 소스로 사전 설정되어 있어 수동 API 키 입력이 필요 없습니다. 다만 필요 시 사용자 지정 TMDB API 키를 구성할 수도 있습니다.

참고: TMDB API 키 설정이나 HOST 설정 변경에 익숙하지 않은 경우 기본 설정을 유지하는 것이 좋습니다. 특정 요구 사항이 있는 사용자는 콘솔에서 TMDB 데이터 소스 설정을 필요에 따라 조정할 수 있습니다.

개인 API 키 사용의 장점

접근 안정성 보장 – 개인 등록 API 키는 공개 API 속도 제한으로 인한 데이터 검색 실패를 방지합니다.
서비스 품질 향상 – 개인 API 키를 사용하면 언어 선호도, 영화 등급 시스템 및 기타 설정을 맞춤화하여 더 정확한 메타데이터를 얻을 수 있습니다.

참고: TMDB 데이터 사용은 TMDB 이용 약관을 준수해야 합니다.

TMDB API 키 신청하기

TMDB API 키 신청 절차:

1. TMDB 공식 웹사이트를 방문하여 계정에 로그인하세요. 계정이 없는 경우 먼저 생성하세요.

2. 로그인 후 오른쪽 상단의 "프로필 아바타"를 클릭하고 [계정 설정]을 선택하세요.

3. [계정 설정] 페이지에서 왼쪽 사이드바의 [API] 섹션으로 이동하여 [API 키 요청] 아래의 "여기를 클릭하세요"를 클릭하세요.

4. API 키 생성 시 계정 유형으로 "개발자"를 선택하세요.

5. 이용 약관을 읽고 동의한 후 신청 세부 정보를 입력하세요:

사용 유형: 개인용 선택.
애플리케이션 이름: 사용자 정의 이름 지정 (예: UGREEN "Theater")
애플리케이션 URL: UGREEN NAS IP 주소(예 : http://192.168.1.31) 를 입력하세요 . [제어판] > [네트워크] > [네트워크 연결]에서 확인할 수 있습니다.
애플리케이션 설명: 애플리케이션과 API 사용 방법을 간략히 기술하세요.

영화 및 TV 센터는 홈 멀티미디어 애플리케이션으로, TMDB 비디오 데이터와 포스터 이미지를 가져와 아름다운 포스터 벽을 구축하는 데 사용됩니다.

개인 정보: 가정 주소 등의 세부 정보를 입력하세요(이 정보는 TMDB에 저장되며 Theater에서는 접근하지 않습니다).

6. 양식 작성을 완료한 후 "제출"을 클릭하고 TMDB에서 API 키를 생성할 때까지 기다리십시오.

7. API 키 생성 후, 이를 복사하여 안전하게 보관하십시오. 구성 과정에서 이 주소가 필요할 것입니다.

TMDB 데이터 소스 설정

1. "Theater" 앱을 열고 오른쪽 상단의 [설정] 버튼을 클릭하여 극장 설정 페이지로 이동하세요.

2. 설정 페이지에서 [데이터 소스] 옵션을 클릭하세요. The Movie Database (TMDB)를 찾아 탭하여 TMDB 설정 화면으로 진입하세요.

3. TMDB 설정 페이지에서 API 키 입력 필드를 찾으세요. 이전에 획득한 TMDB API 키를 해당 필드에 붙여넣으세요.

4. [확인] 버튼을 클릭하여 API 키 유효성을 검증합니다. 테스트가 성공하면 검증 통과를 알리는 확인 메시지가 표시됩니다.

[적용]을 클릭하여 TMDB 데이터 소스 설정을 저장합니다.

라이브러리 동영상 정보 소스 조정

1. 설정 후 라이브러리의 동영상 정보 출처를 TMDB로 설정하여 포스터 및 기타 메타데이터를 가져옵니다.

2. 설정 페이지로 돌아가 [라이브러리] 옵션을 클릭합니다.

3. 라이브러리 목록에서 데이터 소스를 변경할 라이브러리를 선택합니다.

4. 라이브러리 오른쪽의 [···] 버튼을 클릭하고 [편집]을 선택합니다.

5. 편집 페이지에서 [동영상 정보] 옵션을 찾습니다.

6. 소스를 길게 눌러 드래그하여 순서를 재배열하고, TMDB를 최우선 순위로 설정합니다.

7. [적용] 버튼을 클릭하여 설정을 저장합니다.

라이브러리 재스캔

1. 설정 저장 후 라이브러리 페이지로 돌아갑니다.

2. 미디어 라이브러리 오른쪽의 [···] 버튼을 클릭하고 [스캔]을 선택하세요.

3. 스캔 옵션에서 [모두 스캔 및 교체]를 클릭합니다. 이 작업은 미디어 라이브러리의 모든 파일을 재스캔하고 TMDB에서 최신 메타데이터와 포스터를 가져옵니다.

참고: API 키 인증이 성공한 경우 일반적으로 HOST 설정이 필요하지 않습니다. HOST 설정은 DNS 오염 문제를 우회하여 TMDB의 정확한 IP 주소를 확인함으로써 데이터 소스에 대한 안정적인 접근을 보장하기 위해 사용됩니다.

TMDB 정보

메타데이터가 올바르게 표시되지 않는 경우

설정 후에도 메타데이터가 올바르게 표시되지 않으면 다음 단계를 시도하십시오:

TMDB API 키가 올바르게 입력되고 저장되었는지 확인하십시오.
TMDB API 감지가 연결 성공을 확인하는지 확인하십시오.
HOST 설정에서 구성된 IP 주소가 올바르게 확인되는지 확인하십시오.
문제가 지속되면 "모두 스캔 및 교체"를 사용하여 미디어 라이브러리를 수동으로 새로 고침하십시오.

TMDB 데이터 소스 구성에 추가 비용이 필요한지 여부

TMDB는 기본 서비스를 무료로 제공하지만, 고급 기능이나 대량 액세스(예: 빈번한 메타데이터 업데이트)의 경우 TMDB 계정을 등록하여 API 키를 획득해야 합니다. 사용 정책에 대한 자세한 내용은 TMDB 공식 가이드라인을 참조하십시오.

HOST 구성 정보

일부 지역에서는 TMDB API가 DNS 확인 실패를 겪을 수 있습니다. 이를 해결하기 위해 Theater 앱은 HOST 설정 옵션을 제공하여 사용자가 TMDB의 올바른 IP 주소를 수동으로 할당할 수 있게 합니다. 이는 잘못된 공용 DNS 확인을 우회하고 데이터 소스에 대한 안정적인 접근을 보장합니다.

참고: HOST 파일 설정은 오직 TMDB 메타데이터 수집 프로세스 최적화를 목적으로 하며, Theater 앱이 포스터 및 설명과 같은 영화 메타데이터를 정확히 검색할 수 있도록 합니다. UGREEN NAS는 어떠한 동영상 리소스도 제공하지 않으며, 사용자는 자신의 동영상 다운로드 및 저장을 직접 관리해야 합니다.

호스트 설정으로 무엇을 할 수 있나요?

Theater 앱 사용 시 메타데이터 수집 기능은 외부 메타데이터 서비스를 통해 상세한 영화 정보를 가져옵니다.
네트워크 제한이나 서비스 제공업체의 문제로 인해 이 스크래핑 기능이 항상 제대로 작동하지 않을 수 있습니다. HOST 파일을 구성하여 해당 메타데이터 서비스를 해결할 IP 주소를 지정하면 잠재적인 네트워크 문제를 효과적으로 우회하고 원활한 메타데이터 검색을 보장할 수 있습니다.

TMDB의 IP 주소 확인 방법

1. IPADDRESS.COM을 방문합니다.

2. 검색창에 api.tmdb.org를 입력하고 Enter 키를 누릅니다.

3. 페이지 하단으로 스크롤하여 시스템이 확인한 IP 주소를 확인하세요. 구성 과정에서 나중에 사용될 예정이므로 해당 주소를 복사하여 적절히 저장하세요.

호스트 구성 방법

1. [Theater] 앱을 열고 오른쪽 상단의 [설정] 버튼을 클릭하여 설정 인터페이스로 진입합니다.

2. [데이터 소스]를 클릭하고 [The Movie Database]를 선택한 후, 앞서 확인한 IP 주소를 HOSTS 구성 입력란에 붙여넣으세요. 형식이 올바른지 확인하세요: IP 주소 + 공백 + 도메인 이름.

3. TMDB 설정에서 호스트를 다음과 같은 형식으로 입력합니다. 예시:

52.85.151.18 api.themoviedb.org

정보를 확인한 후 "가져오기"를 클릭하여 설정을 완료하세요.
변경 사항을 저장하려면 "적용"을 클릭하세요.

용어집

DNS 오염: 사용자가 합법적인 웹사이트에 접근하지 못하도록 DNS 응답을 위조하거나 변경하는 행위.