TMDB API 키를 생성하고 Kodi에 추가하는 방법

Kodi 애드온에서 TMDB 자격 증명을 요구하는 경우, TMDB 계정을 통해 자격 증명을 요청하고 해당 애드온 설정에 입력하세요. Kodi 자체에는 시스템 전체에서 사용할 수 있는 TMDB API 키 입력란이 없으므로, 애드온이 사용자 지정 키를 지원해야 합니다. 애드온이 공유 자격 증명에 의존하는 경우 개인 키를 사용하면 도움이 될 수 있지만, TMDB의 사용량 제한을 우회하거나 충돌 문제를 해결해 주지는 않습니다.

아래 인터페이스 이미지는 예시일 뿐입니다. TMDB는 계정 관리 방식을 변경할 수 있으며, Kodi 메뉴는 스킨, 기기 및 애드온에 따라 다를 수 있습니다.

시작하기 전에

TMDB 계정과 TMDB API를 사용하고 사용자 지정 자격 증명 설정을 제공하는 Kodi 애드온이 필요합니다. TMDB는 API 등록 절차가 모바일에 최적화되어 있지 않으므로 데스크톱 브라우저에서 신청하는 것을 권장합니다. TMDB 시작하기 가이드 에서 액세스 요청 방법과 동의해야 하는 약관 링크를 확인할 수 있습니다.

TMDB는 두 가지 애플리케이션 자격 증명을 나열합니다. 하나는 API 키(v3 인증) 이고 다른 하나는 API 읽기 액세스 토큰(v4 인증)입니다 . TMDB는 두 가지 모두 API 요청을 인증하는 방법으로 설명하지만, 특정 추가 기능은 한 가지 형식만 허용할 수 있습니다. 자격 증명은 추가 기능이 실제로 요청하는 필드와 일치해야 합니다. v4 베어러 토큰을 명시적으로 요구하는 필드에 v3 키를 붙여넣지 마십시오.

TMDB API 키를 생성하는 방법

1. TMDB 계정을 만들거나 로그인하세요. 영화 데이터베이스 웹사이트(The Movie Database)를 방문하여 필요한 경우 등록하고, 요청하는 계정 인증 절차를 완료하세요. 그런 다음 데스크톱 브라우저를 사용하여 로그인하세요.

   

2. API 설정 페이지를 엽니다. 계정에서 설정을 열고 계정 탐색 메뉴에서 API를 선택하세요. 현재 TMDB 문서에서는 API 링크가 계정 설정의 일부로 설명되어 있지만, 정확한 위치나 문구는 변경될 수 있습니다.

   

3. API 신청을 시작하세요. API 페이지의 요청 절차 또는 생성 흐름을 따르세요. 실제 사용 목적에 맞는 애플리케이션 유형을 선택하고, 소프트웨어에 대한 정확한 설명과 API 사용 계획을 입력한 후, 약관 및 API 가이드라인을 검토하고 동의하세요. 허위 연락처 또는 프로젝트 정보를 사용하지 마세요.

   

4. TMDB에서 인증 정보를 발급할 때까지 기다리세요. 신청이 승인되면 API 설정으로 돌아가서 API 키(v3 인증)와 API 읽기 액세스 토큰(v4 인증) 두 항목을 확인하세요. 이 두 가지는 별도의 애플리케이션 인증 정보입니다. TMDB 인증 가이드에서 사용 가능한 인증 방법을 확인할 수 있습니다.

   

5. 애드온에서 요청하는 자격 증명을 복사하세요. 해당 필드에 'API 키'라고 표시되어 있으면 API 키(v3 인증) 를 복사하고 , 'API 읽기 액세스 토큰' 또는 '베어러 토큰'을 명시적으로 요청하는 경우에는 해당 v4 값을 사용하세요. 둘 중 어떤 것이 맞는지 추측하지 말고, 자격 증명을 공개 게시물이나 스크린샷에 포함시키지 마세요.

   

Kodi에 키를 추가하는 방법

6. Kodi의 추가 기능 영역을 엽니다. 홈 화면에서 '추가 기능'을 선택하고 추가 기능 브라우저 또는 설치된 추가 기능을 엽니다. 이름과 레이아웃은 Kodi 버전 및 스킨에 따라 다를 수 있습니다.

   

7. 호환되는 추가 기능의 설정을 엽니다. TMDB에서 영화 또는 TV 프로그램 메타데이터를 가져오는 추가 기능을 찾아 선택하고 Kodi의 컨텍스트 메뉴를 열어 설정을 선택합니다. Kodi 추가 기능 설명서 에 이 방법이 나와 있습니다. 컨텍스트 메뉴의 이름은 리모컨이나 기기에 따라 다를 수 있습니다. 추가 기능 설명서에서 사용자 지정 TMDB 자격 증명을 지원하는지 확인하십시오.

   

8. 키를 입력하고 저장합니다. 추가 기능의 계정, 메타데이터 또는 API 섹션을 열고 TMDB API 키 필드를 찾습니다. 복사한 값을 붙여넣고 양 끝에 공백이 없는지 확인한 후 확인 또는 저장을 선택합니다. 추가 기능에서 다른 자격 증명 유형을 요청하는 경우 TMDB에서 해당 값을 사용합니다. 추가 기능 설명서에 설정이 다시 시작 후에 적용된다고 명시된 경우에만 추가 기능을 다시 시작합니다.

   

추가 기능에 여전히 오류가 있는 경우

• API 키 필드가 없습니다. 해당 애드온은 사용자 지정 TMDB 자격 증명을 지원하지 않을 수 있습니다. Kodi에는 애드온 자체 구성을 대체할 수 있는 전역 설정이 없습니다.
• 인증 오류: 값이 완전히 복사되었는지, 그리고 추가 기능에서 지정한 자격 증명 유형을 사용했는지 확인하십시오. API 키와 API 읽기 액세스 토큰은 TMDB 계정 설정에서 서로 다른 필드입니다.
• 요청량 제한 또는 연결 오류: 개인 키를 사용한다고 해서 TMDB의 요청량 제한에서 예외가 되는 것은 아닙니다. 추가 기능이 여전히 너무 많은 요청을 보내고 있거나 TMDB를 일시적으로 사용할 수 없는 상태일 수 있습니다. 추가 설정을 변경하기 전에 추가 기능 로그와 TMDB 서비스 상태를 확인하십시오.
• 카테고리가 여전히 충돌하는 경우: 키로는 관련 없는 추가 기능 코드를 복구할 수 없거나, 메타데이터 통합이 오래되었거나, 종속성이 손상되었을 수 있습니다. 신뢰할 수 있는 출처에서만 업데이트하고 해당 추가 기능의 최신 문서를 따르세요. 이전 가이드에서 Covenant 또는 Elysium이 언급될 수 있지만, 이러한 추가 기능은 자체 설정 및 버전 기록을 가지고 있으며 메뉴 경로가 모든 Kodi 추가 기능에 적용되는 것은 아닙니다.

비상업적 API 사용의 경우, TMDB의 API FAQ에 따르면 데이터와 이미지의 출처를 명시해야 합니다. 상업적 프로젝트의 경우 라이선스 관련 문의는 TMDB에 직접 연락하도록 안내하고 있습니다. 기존 애드온을 구성하는 경우에는 애드온 관리자의 지침을 따르고 개인 자격 증명을 공개하지 마십시오.