@pddo/tmdb
TypeScript icon, indicating that this package has built-in type declarations

1.0.1 • Public • Published

@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!

相关链接

Package Sidebar

Install

npm i @pddo/tmdb

Weekly Downloads

4

Version

1.0.1

License

MIT

Unpacked Size

16 kB

Total Files

6

Last publish

Collaborators

  • pddo