Documentation
¶
Overview ¶
Package javdb is the public Go SDK for the JavDB app JSON API.
Index ¶
- Constants
- func ActorPeriod(period string) string
- func FilterMagnets(magnets []map[string]any, cnsub, hd bool, minSize int) []map[string]any
- func LoadOrCreateDeviceUUID(path string) (string, error)
- func MagnetURI(m map[string]any) string
- func PickBestMagnet(magnets []map[string]any) map[string]any
- type APIError
- type AuthRequired
- type BrowseOptions
- type Client
- func (c *Client) API() *appapi.Client
- func (c *Client) AllEntityMovies(ctx context.Context, kind, entityID string, opt EntityMoviesOptions, ...) ([]map[string]any, error)
- func (c *Client) Browse(ctx context.Context, opt BrowseOptions) (SearchResult, error)
- func (c *Client) Collected(ctx context.Context, kind string) ([]map[string]any, error)
- func (c *Client) EntityDetail(ctx context.Context, kind, id string) (map[string]any, error)
- func (c *Client) EntityMovies(ctx context.Context, kind, entityID string, opt EntityMoviesOptions) (SearchResult, error)
- func (c *Client) ListInfo(ctx context.Context, listID string) (map[string]any, error)
- func (c *Client) LoadOrRefreshTaxonomy(ctx context.Context, zone string, force bool) (*tags.Doc, string, error)
- func (c *Client) Login(ctx context.Context, username, password string) (string, error)
- func (c *Client) Mark(ctx context.Context, movieID, status string, score int, content string) (map[string]any, error)
- func (c *Client) MovieDetail(ctx context.Context, movieID string) (map[string]any, error)
- func (c *Client) MovieMagnets(ctx context.Context, movieID string) ([]map[string]any, error)
- func (c *Client) MyLists(ctx context.Context, page, limit int, sortBy string) (SearchResult, error)
- func (c *Client) RankingsActors(ctx context.Context, period string) (SearchResult, error)
- func (c *Client) RankingsMovies(ctx context.Context, type_, period string) (SearchResult, error)
- func (c *Client) RankingsPlayback(ctx context.Context, filterBy, period string) (SearchResult, error)
- func (c *Client) RecentViewed(ctx context.Context) ([]map[string]any, error)
- func (c *Client) RefreshTagTaxonomy(ctx context.Context, zone string) (*tags.Doc, error)
- func (c *Client) RelatedLists(ctx context.Context, movieID string, page, limit int) (SearchResult, error)
- func (c *Client) ResolveEntity(ctx context.Context, kind, ref, zone string) (string, error)
- func (c *Client) ResolveMovieID(ctx context.Context, number string) (string, error)
- func (c *Client) ResolveTags(ctx context.Context, refs []string, zone string) ([]string, error)
- func (c *Client) ResolveUserID(ctx context.Context) (userID int64, username string, err error)
- func (c *Client) Search(ctx context.Context, keyword string, opt SearchOptions) (SearchResult, error)
- func (c *Client) SetToken(token string)
- func (c *Client) Token() string
- func (c *Client) Top250(ctx context.Context, zone, year string, startRank, page, limit int, ...) (SearchResult, error)
- func (c *Client) Unmark(ctx context.Context, movieID string) (bool, error)
- func (c *Client) WantMovies(ctx context.Context) ([]map[string]any, error)
- func (c *Client) WatchedMovies(ctx context.Context) ([]map[string]any, error)
- type EntityMoviesOptions
- type Option
- type SearchOptions
- type SearchResult
Constants ¶
const ( HostMirror = config.HostMirror HostMain = config.HostMain )
Host constants.
Variables ¶
This section is empty.
Functions ¶
func FilterMagnets ¶
Re-export magnet helpers for SDK callers.
func LoadOrCreateDeviceUUID ¶ added in v0.2.0
LoadOrCreateDeviceUUID loads the stable device identifier at path or creates one when the file is absent. CLI callers use it before constructing a client; SDK callers may use it when they need the same identifier across processes.
Types ¶
type Client ¶
type Client struct {
// contains filtered or unexported fields
}
Client is a concrete app-API client.
func (*Client) API ¶
API 为兼容旧调用方返回底层 adapter。该返回值不是稳定的外部 SDK 契约；新代码应优先使用 typed 方法。 Deprecated: use the documented Client methods instead.
func (*Client) AllEntityMovies ¶
func (c *Client) AllEntityMovies(ctx context.Context, kind, entityID string, opt EntityMoviesOptions, maxPages int) ([]map[string]any, error)
AllEntityMovies aggregates filmography pages.
func (*Client) Browse ¶
func (c *Client) Browse(ctx context.Context, opt BrowseOptions) (SearchResult, error)
Browse lists movies by category filters.
func (*Client) EntityDetail ¶
EntityDetail fetches entity meta.
func (*Client) EntityMovies ¶
func (c *Client) EntityMovies(ctx context.Context, kind, entityID string, opt EntityMoviesOptions) (SearchResult, error)
EntityMovies lists filmography for an entity kind.
func (*Client) LoadOrRefreshTaxonomy ¶
func (c *Client) LoadOrRefreshTaxonomy(ctx context.Context, zone string, force bool) (*tags.Doc, string, error)
LoadOrRefreshTaxonomy loads disk taxonomy or refreshes.
func (*Client) Login ¶
Login authenticates and stores the token on the client. ctx is reserved for future cancellation; the underlying client is not yet context-aware.
func (*Client) Mark ¶
func (c *Client) Mark(ctx context.Context, movieID, status string, score int, content string) (map[string]any, error)
Mark marks a movie watched or want_watch.
func (*Client) MovieDetail ¶
MovieDetail returns GET /api/v4/movies/{id} nested movie map.
func (*Client) MovieMagnets ¶
MovieMagnets returns GET /api/v1/movies/{id}/magnets (auth required).
func (*Client) RankingsActors ¶
RankingsActors fetches actor rankings (period already daily/weekly/monthly or use ActorPeriod).
func (*Client) RankingsMovies ¶
RankingsMovies fetches movie rankings.
func (*Client) RankingsPlayback ¶
func (c *Client) RankingsPlayback(ctx context.Context, filterBy, period string) (SearchResult, error)
RankingsPlayback fetches playback rankings.
func (*Client) RecentViewed ¶
RecentViewed returns recently viewed movies.
func (*Client) RefreshTagTaxonomy ¶
RefreshTagTaxonomy downloads EN+ZH taxonomies and saves tags-{zone}.json.
func (*Client) RelatedLists ¶
func (c *Client) RelatedLists(ctx context.Context, movieID string, page, limit int) (SearchResult, error)
RelatedLists returns public lists related to a movie.
func (*Client) ResolveEntity ¶
ResolveEntity resolves name/id to entity id.
func (*Client) ResolveMovieID ¶
ResolveMovieID maps a printed number to internal id (search zone=all).
func (*Client) ResolveTags ¶
ResolveTags maps free-form tag refs to ids.
func (*Client) ResolveUserID ¶
ResolveUserID returns the numeric user id (and optional display name) for the current token.
func (*Client) Search ¶
func (c *Client) Search(ctx context.Context, keyword string, opt SearchOptions) (SearchResult, error)
Search runs GET /api/v2/search.
func (*Client) Top250 ¶
func (c *Client) Top250(ctx context.Context, zone, year string, startRank, page, limit int, ignoreWatched bool) (SearchResult, error)
Top250 fetches TOP250 (auth).
func (*Client) WantMovies ¶
WantMovies returns all want_watch (想看) movies.
type EntityMoviesOptions ¶
type EntityMoviesOptions = appapi.EntityMoviesOptions
EntityMoviesOptions re-export.
type Option ¶
type Option func(*options)
Option configures New.
func WithDeviceUUID ¶
WithDeviceUUID sets the app device_uuid public param.
type SearchOptions ¶
type SearchOptions = appapi.SearchOptions
SearchOptions is re-exported for SDK callers.
Source Files