Skip to content

Latest commit

 

History

History
376 lines (268 loc) · 13.5 KB

HistoryApi.md

File metadata and controls

376 lines (268 loc) · 13.5 KB

lidarr.HistoryApi

All URIs are relative to http://localhost:8686

Method HTTP request Description
create_history_failed_by_id POST /api/v1/history/failed/{id}
get_history GET /api/v1/history
list_history_artist GET /api/v1/history/artist
list_history_since GET /api/v1/history/since

create_history_failed_by_id

create_history_failed_by_id(id)

Example

  • Api Key Authentication (apikey):
  • Api Key Authentication (X-Api-Key):
import lidarr
from lidarr.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to http://localhost:8686
# See configuration.py for a list of all supported configuration parameters.
configuration = lidarr.Configuration(
    host = "http://localhost:8686"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure API key authorization: apikey
configuration.api_key['apikey'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['apikey'] = 'Bearer'

# Configure API key authorization: X-Api-Key
configuration.api_key['X-Api-Key'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['X-Api-Key'] = 'Bearer'

# Enter a context with an instance of the API client
with lidarr.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = lidarr.HistoryApi(api_client)
    id = 56 # int | 

    try:
        api_instance.create_history_failed_by_id(id)
    except Exception as e:
        print("Exception when calling HistoryApi->create_history_failed_by_id: %s\n" % e)

Parameters

Name Type Description Notes
id int

Return type

void (empty response body)

Authorization

apikey, X-Api-Key

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

HTTP response details

Status code Description Response headers
2XX OK -

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_history

HistoryResourcePagingResource get_history(page=page, page_size=page_size, sort_key=sort_key, sort_direction=sort_direction, include_artist=include_artist, include_album=include_album, include_track=include_track, event_type=event_type, album_id=album_id, download_id=download_id, artist_ids=artist_ids, quality=quality)

Example

  • Api Key Authentication (apikey):
  • Api Key Authentication (X-Api-Key):
import lidarr
from lidarr.models.history_resource_paging_resource import HistoryResourcePagingResource
from lidarr.models.sort_direction import SortDirection
from lidarr.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to http://localhost:8686
# See configuration.py for a list of all supported configuration parameters.
configuration = lidarr.Configuration(
    host = "http://localhost:8686"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure API key authorization: apikey
configuration.api_key['apikey'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['apikey'] = 'Bearer'

# Configure API key authorization: X-Api-Key
configuration.api_key['X-Api-Key'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['X-Api-Key'] = 'Bearer'

# Enter a context with an instance of the API client
with lidarr.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = lidarr.HistoryApi(api_client)
    page = 1 # int |  (optional) (default to 1)
    page_size = 10 # int |  (optional) (default to 10)
    sort_key = 'sort_key_example' # str |  (optional)
    sort_direction = lidarr.SortDirection() # SortDirection |  (optional)
    include_artist = True # bool |  (optional)
    include_album = True # bool |  (optional)
    include_track = True # bool |  (optional)
    event_type = [56] # List[int] |  (optional)
    album_id = 56 # int |  (optional)
    download_id = 'download_id_example' # str |  (optional)
    artist_ids = [56] # List[int] |  (optional)
    quality = [56] # List[int] |  (optional)

    try:
        api_response = api_instance.get_history(page=page, page_size=page_size, sort_key=sort_key, sort_direction=sort_direction, include_artist=include_artist, include_album=include_album, include_track=include_track, event_type=event_type, album_id=album_id, download_id=download_id, artist_ids=artist_ids, quality=quality)
        print("The response of HistoryApi->get_history:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling HistoryApi->get_history: %s\n" % e)

Parameters

Name Type Description Notes
page int [optional] [default to 1]
page_size int [optional] [default to 10]
sort_key str [optional]
sort_direction SortDirection [optional]
include_artist bool [optional]
include_album bool [optional]
include_track bool [optional]
event_type List[int] [optional]
album_id int [optional]
download_id str [optional]
artist_ids List[int] [optional]
quality List[int] [optional]

Return type

HistoryResourcePagingResource

Authorization

apikey, X-Api-Key

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status code Description Response headers
2XX OK -

[Back to top] [Back to API list] [Back to Model list] [Back to README]

list_history_artist

List[HistoryResource] list_history_artist(artist_id=artist_id, album_id=album_id, event_type=event_type, include_artist=include_artist, include_album=include_album, include_track=include_track)

Example

  • Api Key Authentication (apikey):
  • Api Key Authentication (X-Api-Key):
import lidarr
from lidarr.models.entity_history_event_type import EntityHistoryEventType
from lidarr.models.history_resource import HistoryResource
from lidarr.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to http://localhost:8686
# See configuration.py for a list of all supported configuration parameters.
configuration = lidarr.Configuration(
    host = "http://localhost:8686"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure API key authorization: apikey
configuration.api_key['apikey'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['apikey'] = 'Bearer'

# Configure API key authorization: X-Api-Key
configuration.api_key['X-Api-Key'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['X-Api-Key'] = 'Bearer'

# Enter a context with an instance of the API client
with lidarr.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = lidarr.HistoryApi(api_client)
    artist_id = 56 # int |  (optional)
    album_id = 56 # int |  (optional)
    event_type = lidarr.EntityHistoryEventType() # EntityHistoryEventType |  (optional)
    include_artist = False # bool |  (optional) (default to False)
    include_album = False # bool |  (optional) (default to False)
    include_track = False # bool |  (optional) (default to False)

    try:
        api_response = api_instance.list_history_artist(artist_id=artist_id, album_id=album_id, event_type=event_type, include_artist=include_artist, include_album=include_album, include_track=include_track)
        print("The response of HistoryApi->list_history_artist:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling HistoryApi->list_history_artist: %s\n" % e)

Parameters

Name Type Description Notes
artist_id int [optional]
album_id int [optional]
event_type EntityHistoryEventType [optional]
include_artist bool [optional] [default to False]
include_album bool [optional] [default to False]
include_track bool [optional] [default to False]

Return type

List[HistoryResource]

Authorization

apikey, X-Api-Key

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status code Description Response headers
2XX OK -

[Back to top] [Back to API list] [Back to Model list] [Back to README]

list_history_since

List[HistoryResource] list_history_since(var_date=var_date, event_type=event_type, include_artist=include_artist, include_album=include_album, include_track=include_track)

Example

  • Api Key Authentication (apikey):
  • Api Key Authentication (X-Api-Key):
import lidarr
from lidarr.models.entity_history_event_type import EntityHistoryEventType
from lidarr.models.history_resource import HistoryResource
from lidarr.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to http://localhost:8686
# See configuration.py for a list of all supported configuration parameters.
configuration = lidarr.Configuration(
    host = "http://localhost:8686"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure API key authorization: apikey
configuration.api_key['apikey'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['apikey'] = 'Bearer'

# Configure API key authorization: X-Api-Key
configuration.api_key['X-Api-Key'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['X-Api-Key'] = 'Bearer'

# Enter a context with an instance of the API client
with lidarr.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = lidarr.HistoryApi(api_client)
    var_date = '2013-10-20T19:20:30+01:00' # datetime |  (optional)
    event_type = lidarr.EntityHistoryEventType() # EntityHistoryEventType |  (optional)
    include_artist = False # bool |  (optional) (default to False)
    include_album = False # bool |  (optional) (default to False)
    include_track = False # bool |  (optional) (default to False)

    try:
        api_response = api_instance.list_history_since(var_date=var_date, event_type=event_type, include_artist=include_artist, include_album=include_album, include_track=include_track)
        print("The response of HistoryApi->list_history_since:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling HistoryApi->list_history_since: %s\n" % e)

Parameters

Name Type Description Notes
var_date datetime [optional]
event_type EntityHistoryEventType [optional]
include_artist bool [optional] [default to False]
include_album bool [optional] [default to False]
include_track bool [optional] [default to False]

Return type

List[HistoryResource]

Authorization

apikey, X-Api-Key

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status code Description Response headers
2XX OK -

[Back to top] [Back to API list] [Back to Model list] [Back to README]