seznam objektu
\n\n [{\"column\": <razeni>,\n\
\ \"ascending\": <vzestupne?>},\n ... ]\n \n\
\ povolene hodnoty <razeni>:
\n<vzestupne?>\ \ je true nebo false
\n\nobjekt {<klic>:\ \ <hodnota>, ...}
\nVšechny prvky nemusí být vyplněny\ \ (závisí na providerovi). Některé prvky jsou \"specifické pro providera\"\ \ - většinou se jedná o id.
\n\n\n {\n provider:\
\ poskytovatel produktu\n id: identifikator produktu u poskytovatele\n\
\ title: {\n CZ|SK|EN: název\n }\n \
\ subtitle: {\n CZ|SK|EN: podtitul\n }\n \
\ safe_title: {\n CZ|SK|EN: safe title (bez háčků/čárek, mezery\
\ -> _, pouze alfanumerické znaky a _-.\n }\n description:\
\ {\n CZ|SK|EN: popis\n }\n release_date:\
\ datum vydání\n available_from: dostupné od data\n \
\ available_to: dostupné do data\n authors: [\n {\n\
\ name: jméno autora,\n role: popis role\n \
\ }\n ]\n previews: [\n {\n \
\ name: název,\n purpose: účel,\n \
\ location: link\n }\n ]\n images: [\n\
\ {\n name: název,\n purpose: účel,\n\
\ location: link\n }\n ]\n \
\ files: [\n {\n name: název,\n \
\ purpose: účel,\n location: link\n }\n \
\ ]\n flags: [\n {\n id: identifikace\
\ flagu,\n name: název flagu\n }\n ]\n\
\ categories: [\n {\n id: identifikace\
\ kategorie,\n name: název kategorie\n }\n \
\ ]\n types: [\n {\n type_id: identifikace\
\ typu,\n name: název typu,\n prices: {\n \
\ CZK|EUR: cena\n },\n variants:\
\ [\n {\n purpose_id: id varianty,\n \
\ purpose: popis varianty\n }\n \
\ ]\n }\n ]\n attributes: {\n \
\ length_seconds: délka v sekundách,\n copyright: copyright,\n\
\ popularity: popularita (0-10),\n identification: {\n\
\ grid|upc|isrc|ean|cro|generic: identifikace\n \
\ },\n track_number: pořadí tracku,\n volume_number:\
\ pořadí volume\n }\n status: presell|available|canceled\n\
\ regions: {\n cz|sk|global: {\n download:\
\ bool,\n stream: bool\n }\n }\n \
\ campaigns: [\n {\n id: id kampaně,\n \
\ name: název kampaně,\n valid_from: platnost\
\ od,\n valid_to: platnost do,\n attributes:\
\ atributy kampaně,\n price_change: {\n change_type:\
\ fix|ratio|sub,\n amount: {\n CZK|EUR:\
\ hodnota\n },\n types: typy kterých se kampan\
\ tyka\n }\n }\n ]\n }\n \
\ \n\n Pokud si synchronizujete katalog, a stav položky\ \ je \"canceled\", odeberte prosím položku z vašeho katalogu.
\n \ \ " requestBody: content: application/json: schema: properties: available_only: type: boolean category_id: type: integer count: type: integer distributor_key: type: string filters: properties: {} type: object offset: type: integer order: items: properties: {} type: object type: array provider: type: string show_details: type: boolean required: - provider - category_id - distributor_key type: object responses: '200': content: application/json: schema: properties: category_list: type: object status: example: 200 type: number status_message: example: OK type: string type: object description: OK summary:Vrací stream produktů. Jednotlivé produkty jsou odděleny\ \ nullbytem 0x00.\n Pro správnou funkci je třeba v hlavičkách uvést\ \ Accept: application/json-nullstream
\n\nStruktura produktu v odpovědi odpovídá struktuře\ \ odpovědi metody item_detail()
\n\nV případě chyby při zpracování\ \ je nullstream ukončen a jako poslední item je\n přidán chybový objekt:
\n\ \ { \"status\": <int - kód chyby>, \"status_message\":\
\ \"popis chyby\" } \n "
requestBody:
content:
application/json:
schema:
properties:
available_only:
type: boolean
category_id:
type: integer
distributor_key:
type: string
filters:
properties: {}
type: object
order:
items:
properties: {}
type: object
type: array
provider:
type: string
required:
- distributor_key
type: object
responses:
'200':
content:
application/json:
schema:
properties:
category_list_nullstream:
type: object
status:
example: 200
type: number
status_message:
example: OK
type: string
type: object
description: OK
summary: Vrací stream produktů. Jednotlivé produkty jsou odděleny nullbytem 0x00. /changes: post: description: "\n Vrací přehled změn\n " requestBody: content: application/json: schema: type: object responses: '200': content: application/json: schema: properties: changes: type: object status: example: 200 type: number status_message: example: OK type: string type: object description: OK summary: Vrací přehled změn /faq: post: description: "\n Vrací odpovědi na často kladené dotazy\n " requestBody: content: application/json: schema: type: object responses: '200': content: application/json: schema: properties: faq: type: object status: example: 200 type: number status_message: example: OK type: string type: object description: OK summary: Vrací odpovědi na často kladené dotazy /get_event: post: description: "\n Fetches the event from the database corresponding to\ \ the provided id.\n\n Arguments:\n c (cursor): Database\ \ cursor used to execute SQL queries.\n id (str): Identifier of\ \ the event to fetch.\n\n Returns:\n tuple: A tuple containing\ \ id, user_id, time, action, and extra from the\n database if the\ \ event is found, otherwise None.\n " requestBody: content: application/json: schema: properties: id: type: string required: - id type: object responses: '200': content: application/json: schema: properties: get_event: type: object status: example: 200 type: number status_message: example: OK type: string type: object description: OK summary: Fetches the event from the database corresponding to the provided id. /item_consume: post: description: "\n
\n Určuje požadovaný typ. Není-ĺi uveden, bere se typ použitý\ \ při objednávce.\n V určitých případech je možné konzumovat i jiné\ \ typy než má zákazník zakoupené\n (např. při zakoupení flac může být\ \ umožněno skladbu získat i ve formátu mp3).\n V takovém případě je\ \ potřeba uvést požadovaný typ. Možnost konzumace jiného než\n zakoupeného\ \ typu se může u jednotlivých produktů lišit. Pro více detailů se, prosím,\n\ \ obraťte na našeho zástupce.\n
\n\n\n V případě, že je poskytováno více variant je třeba předat\ \ purpose_id\n (viz. item_detail()). V některých případech má api nadefinovanou\ \ defaultní\n variantu která je použita v případě, že není purpose_id\ \ předáno.\n
\n\n\n Musicjet umožňuje specifikovat stahování více alb/tracků\ \ v jednom zipu\n (jinak než jako součást jednoho alba) - a k tomu\ \ slouží parametr items.\n
\n\nitems: seznam objektů\ \ popisující produkty ke stažení
\n\n [{\n \
\ 'item_id': id produktu (povinné),\n 'order_id': id objednávky\
\ pro ověření nákupu\n }, ...]\n \n\n \n \ \ V případě že je při volání item_consume() uveden parametr items, jsou\n\ \ ignorovány parametry item_id a order_id.\n
\n\n \ \\n Pro ověření nákupu je možné uvést buď klíč order_id u každé\ \ položky\n v seznamu items, nebo parametr user ve volání metody. Pokud\ \ je využit\n parametr user, je prohledávána celá uživatelova knihovna\ \ a odpověď bude\n pomalejší.\n
\n\n\n \ \ Všechny produkty v balíku budou ve stejném typu/variantě definovanými\n\ \ paremetry type_id a purpose_id.\n
\n\n\n \ \ V balíku budou zahrnuty pouze takové produkty ze seznamu items, které\ \ budou\n dobře popsány a vyhodnoceny jako zakoupené. Ostatní budou\ \ bez varování\n ignorovány. Pokud by ke konzumaci nezbyl žádný produkt,\ \ je vrácena chyba.\n
\n " requestBody: content: application/json: schema: properties: distributor_key: type: string item_id: type: string items: items: {} type: array order_id: type: string provider: type: string purpose_id: type: string request_attrs: properties: {} type: object type_id: type: string user: type: string required: - distributor_key - provider type: object responses: '200': content: application/json: schema: properties: item_consume: type: object status: example: 200 type: number status_message: example: OK type: string type: object description: OK summary:Výsledkem je objekt s informacemi o produktu.\ \ Strukturou odpovídá informacím\n o produktu z výsledku category_list()\ \ jen je doplněn o další podrobnosti:
\n\nitems: list\ \ objektů popisujících subitemy (např tracky v albu)\n strukturou odpovídají\ \ struktuře výsledku volání item_detail()
\n\nPokud si synchronizujete\ \ katalog, a stav položky je \"canceled\", odeberte\n prosím položku\ \ z vašeho katalogu.
\n " requestBody: content: application/json: schema: properties: distributor_key: type: string item_id: type: string provider: type: string required: - provider - item_id - distributor_key type: object responses: '200': content: application/json: schema: properties: item_detail: type: object status: example: 200 type: number status_message: example: OK type: string type: object description: OK summary:V současné době jsou používány následující klíče pro účely reportingu:
\n\ \Vraci id objednávky.
\n\ \ " requestBody: content: application/json: schema: properties: campaign_ids: items: type: integer type: array currency_id: type: string custom_attrs: properties: {} type: object distributor_key: type: string item_id: type: string price: type: number provider: type: string time: type: string type_id: type: string user: type: string required: - provider - item_id - type_id - user - distributor_key - price - currency_id type: object responses: '200': content: application/json: schema: properties: item_order: type: object status: example: 200 type: number status_message: example: OK type: string type: object description: OK summary:Výsledkem volání\ \ je seznam objektů, které má uživatel zakoupené. Jejich\n struktura\ \ odpovídá struktuře výsledků item_detail(). Navíc jsou doplněny klíče:
\n\ \List of consumption log entries.
\n\nPrepares a SQL\ \ query with the specified filters and executes it to retrieve the logs.
\n\ \ " requestBody: content: application/json: schema: properties: count: type: integer distributor_id: type: integer extra: properties: {} type: object item_id: type: string offset: type: integer order_id: type: string provider: type: string purpose_id: type: string time_from: type: string time_to: type: string type_id: type: string url: type: string user_id: type: string type: object responses: '200': content: application/json: schema: properties: list_consume: type: object status: example: 200 type: number status_message: example: OK type: string type: object description: OK summary:dict: Event records matching the filters\ \ with fields possibly omitted.
\n " requestBody: content: application/json: schema: properties: action: type: string count: type: integer extra: properties: {} type: object id: type: string offset: type: integer omit: items: enum: - items.items type: string type: array time_from: type: string time_to: type: string user_id: type: string type: object responses: '200': content: application/json: schema: properties: list_events: type: object status: example: 200 type: number status_message: example: OK type: string type: object description: OK summary:\n\
\ {\n provider: poskytovatel kategorie,\n category_id:\
\ id kategorie v rámci jejího providera (id kategorie určuje\n \
\ poskytovatel, tedy u dvou poskytovatelů mohou být různé kategorie se\n \
\ stejným id),\n name: název kategorie,\n \
\ childs: seznam podkategorii (stejná struktura jako rodič)\n }\n \
\ \n "
requestBody:
content:
application/json:
schema:
properties:
distributor_key:
type: string
provider:
type: string
required:
- distributor_key
type: object
responses:
'200':
content:
application/json:
schema:
properties:
menu_list:
type: object
status:
example: 200
type: number
status_message:
example: OK
type: string
type: object
description: OK
summary: object: The library\ \ object specific to the user and distributor_key.
\n " requestBody: content: application/json: schema: properties: distributor_key: type: string user: type: string required: - user - distributor_key type: object responses: '200': content: application/json: schema: properties: simple_library: type: object status: example: 200 type: number status_message: example: OK type: string type: object description: OK summary: