@airplanegobrr/jackett-api
v1.0.5
Published
An api for 'Jackett' server requests
Downloads
8
Maintainers
Readme
jackett-api
Overview
The package provides a simple API to communicate with a Jackett server.
Usage overview
| Function | Returns |Description|Exceptions| | ------------- | ------------- |-----------|----------| | isValidServer | Promise <boolean> | Sends an HTTP request to test the connection to the server & tries to parse the result(Tests XML type) || | getTorznabIndexers | Promise<Array<TorznabIndexerModel>> | Fetches a list of all supported trackers on Jackett | - HTTP Error - parse error | | getConfiguredIndexers | Promise<Array<TorznabIndexerModel>> | Fetches a list of all configured trackers on Jackett | - HTTP Error - parse error | | searchAll | Promise<Array<RssResultModel>> | Fetches a list of torrent results, by a given search query, from all configured trackers combined | - HTTP Error - parse error | | searchIndexers | Promise<Array<RssResultModel>> | Fetches a list of torrent results, by a given search query, from given indexers | - HTTP Error - parse error | | getIndexerRss | Promise<Array<RssResultModel>> | Fetches a list of torrent results from an Rss feed of a given indexer | - HTTP Error - parse error | | downloadTorrent | Promise<void> | Downloads a torrent frile of a given RssResult | - HTTP Error - parse error - FileSystem errors(Ex. Permissions) |
Error handling
The API returns promises and it is the implementor׳s responsibility to catch any exception thrown in the process. A list of possible exceptions can be found for each method on the Usage Overview section.
DTO Structure
RssResultModel
Represnting an Rss result item.
class RssResultModel {
private _indexerId: string,
private _indexerName: string,
private _title: string,
private _publishDate: Date,
private _category: string[],
private _downloadLink: string,
/** _size Size of the torrent content **/
private _size: number,
private _fileCount: number,
private _grabs: number,
private _seeders: number,
private _peers: number
}
TorznabIndexerModel
Representing a Jackett Indexer.
class TorznabIndexerModel {
private _id: string,
private _configured: boolean,
private _title: string,
private _description: string,
private _link: string,
private _language: string,
private _type: IndexerType
}
IndexerType
The type of an indexer
enum IndexerType {
private,
public,
}
Initialize example
const jackettService: JackettService = new JackettService({
connectionSettings: {
baseUrl: "https://baseurl.com/jackett/api/v2.0/",
apiKey: "apikey",
},
selfSignedSSL: true,
});
The service requires 3 properties to initialize properly:
baseUrl
- The base url of the Jackett service. Important: your path needs to include the api base. It would probably be something like:/jackett/api/v2.0/
apiKey
- Your API key from Jackett.selfSignedSSL
- The http client this package uses will reject self signed SSL certificates by default. If your Jackett service is hosted with self signed ssl, set this totrue
to allow the connection, otherwise set it tofalse
.
Jackett Version
The code has been tested on Jackett versions: v0.17.xx