mirror of https://github.com/qbittorrent/qBittorrent.git synced 2025-12-17 06:01:33 -06:00

Files

Thomas (Tom) Piccirello 2f34c9b2f0 WebAPI: Omit file names in parseMetadata response

This allows us to bypass any issues related to non-ascii file names.
Supersedes #23080.

PR #23085.

2025-08-23 03:06:24 +08:00

WebAPI Changelog

2.13.0

#23045
- torrents/trackers returns three new fields: next_announce, min_announce and endpoints
  - endpoints is an array of tracker endpoints, each with name, updating, status, msg, bt_version, num_peers, num_peers, num_leeches, num_downloaded, next_announce and min_announce fields
- torrents/trackers now returns 5 and 6 in status field as possible values
- 5 for Tracker error and 6 for Unreachable
#22963
- torrents/editTracker endpoint now supports setting a tracker's tier via tier parameter
- torrents/editTracker endpoint always responds with a 204 when successful
- torrents/editTracker endpoint origUrl parameter renamed to url
#23085
- torrents/parseMetadata now responds with an array of metadata in the same order as the files in the request. It previously responded with an object keyed off of the submitted file name.

#23031
- Add torrents/setComment endpoint with parameters hashes and comment for setting a new torrent comment

#22989
- sync/maindata returns one new field: share_limit_action
- torrents/setShareLimits now requires a new shareLimitAction param that sets a torrent's shareLimitAction property
  - possible values Default, Stop, Remove, RemoveWithContent and EnableSuperSeeding

#22958
- torrents/categories and sync/maindata now serialize categories' downloadPath to null, rather than undefined
#22954
- torrents/reannounce supports specifying individual trackers via trackers field

#21015
- Add torrents/fetchMetadata endpoint for retrieving torrent metadata associated with a URL
- Add torrents/parseMetadata endpoint for retrieving torrent metadata associated with a .torrent file
- Add torrents/saveMetadata endpoint for saving retrieved torrent metadata to a .torrent file
- torrents/add allows adding a torrent with metadata previously retrieved via torrents/fetchMetadata or torrents/parseMetadata
- torrents/add allows specifying a torrent's file priorities
#22698
- torrents/addTrackers and torrents/removeTrackers now accept hash=all and adds/removes the tracker to/from all torrents
  - For compatibility, torrents/removeTrackers still accepts hash=* internally we transform it into all
- Allow passing a pipe (|) separated list of hashes in hash for torrents/addTrackers and torrents/removeTrackers

#21349
- Handle sending 204 No Content status code when response contains no data
  - Some endpoints still return 200 OK to ensure smooth transition
#22750
- torrents/info allows an optional parameter includeFiles that defaults to false
  - Each torrent will contain a new key files which will list all files similar to the torrents/files endpoint
#22813
- app/getDirectoryContent allows an optional parameter withMetadata to send file metadata
  - Fields are name, type, size, creation_date, last_access_date, last_modification_date
  - See PR for TypeScript types

#22166
- sync/maindata returns 3 new torrent fields: has_tracker_warning, has_tracker_error, has_other_announce_error

#22460
- app/setPreferences allows only one of max_ratio_enabled, max_ratio to be present
- app/setPreferences allows only one of max_seeding_time_enabled, max_seeding_time to be present
- app/setPreferences allows only one of max_inactive_seeding_time_enabled, max_inactive_seeding_time to be present