@pddo/tmdb

@pddo/tmdb

TypeScript SDK for The Movie Database (TMDB) API，提供类型安全的 TMDB API 接口。

安装

# 使用 bun
bun add @pddo/tmdb

# 使用 npm
npm install @pddo/tmdb

# 使用 yarn
yarn add @pddo/tmdb

使用方法

首先，你需要从 TMDB 获取 API Bearer Token。

import { TMDB } from '@pddo/tmdb';

// 创建 TMDB 实例
const tmdb = new TMDB('your-bearer-token-here');

// 获取热门电影
const popularMovies = await tmdb.getPopularMovies();
console.log(popularMovies.data.results);

// 获取电影详情
const movieDetails = await tmdb.getMovie('550'); // Fight Club
console.log(movieDetails.data);

// 获取正在上映的电影
const nowPlayingMovies = await tmdb.getNowPlayingMovies();
console.log(nowPlayingMovies.data.results);

// 获取电影图片
const movieImages = await tmdb.getMovieImages('550');
console.log(movieImages.data);

// 获取电影类型列表
const genres = await tmdb.getGenres();
console.log(genres.data.genres);

// 生成完整的图片 URL
const fullImageUrl = TMDB.generateFullImageUrl('/path/to/image.jpg', 'w500');
console.log(fullImageUrl); // https://image.tmdb.org/t/p/w500/path/to/image.jpg

API 方法

getMovie(movieId, language?)

获取电影详情

getPopularMovies(page?, language?, region?)

获取热门电影列表

getNowPlayingMovies(page?, language?, region?)

获取正在上映的电影列表

getMovieImages(movieId, language?, include_image_language?)

获取电影图片（海报、背景图等）

getGenres(language?)

获取电影类型列表

TMDB.generateFullImageUrl(imagePath, size?)

生成完整的图片 URL（静态方法）

类型定义

该包提供完整的 TypeScript 类型定义，包括：

• IMovie - 电影基本信息
• IMovieDetails - 电影详情
• IGenre - 电影类型
• IImage - 图片信息
• 以及各种响应接口

许可证

MIT

贡献

欢迎提交 issue 和 pull request！

相关链接

• TMDB API 文档
• 获取 API Key