ID функции

w_buy_art

Кто может вызывать

Авторизованный пользователь.
Авторизованное приложение.

Принимаемые параметры

arts* – идентификаторы книг, которые надо купить, массив целых чисел;
discount – применение скидки. Необязательный параметр. Может принимать следующие значения:

sequence – применить скидку на серию. При этом серия должна состоять не менее чем из трех книг. Все книги, идентификаторы которых передаются в параметре arts должны принадлежать к одной серии;
podcast – применить скидку на весь подкаст. Все выпуски подкастов, идентификаторы которых передаются в параметре arts должны принадлежать к одному родительскому подкасту;
audio – применить скидку на пакет текстовая книга+аудиокнига. Между книгами должна быть связь по типу «другой носитель» (см. r_linked_to);

lfrom – идентификатор партнера, которому следует зачесть данную покупку. Целое положительное число. Данный ID выдается партнеру «ЛитРес» после подачи заявки на партнерство. Подробнее об условиях партнерской программы «ЛитРес». Если параметр lfrom не передан, покупка не будет зачтена партнеру;
pin – код клиента у партнера (строка до 32 символов). Данный параметр добавляется в отчет о продажах партнера и отображается только в выгрузке XML. Он может быть использован партнером по своему усмотрению. Если lfrom не передан, то данный параметр игнорируется.

currency – валюта, в которой происходит покупка. Ограничение - как для валют инаппов (на 18.03.2021 это RUB, EUR, PLN, USD).

user_choice - признак, выбрал ли пользователь при оплате скидку или бонусные рубли. Необязательный параметр. Может принимать следующие значения:

1 - использовать бонусные рубли
0 - использовать скидку

Если параметр user_choice не передан, при оплате применяются и скидка, и бонусные рубли

Возвращаемые значения

baskets – для каждой купленной книги (arts) возвращается идентификатор корзины – basket_id.

Возможные ошибки

error_code	error_message	Описание
101061	invalid format art ID	Некорректный формат данных в параметре art. Допустимы только целые положительные числа от 1000 до 999999999999
101098	Attempt to buy TTS art	Книга с указанным ID не может быть продана (не существует, временно недоступна, не продаётся в вашем регионе, etc.)
101099	Not enouth money	На внутреннем счете ЛитРес нет достаточных для покупки этих книг средств
101102	Arts allready exists	Книга уже куплена
101019	Invalid currency param	Валюта не входит в список доступных (на 18.03.2021 это RUB, EUR, PLN, USD)

Пример запроса на сервер

{
  "sid": "f121e02084344f06da1a5213999e8fcG",
  "app": "1",
  "time": "2020-06-15T14:16:56+03:00",
  "sha": "b79d8e9993d20da6abe78838d3c7fbf640a4c52956569bef3c685d3453316b5c",
  "requests": [
          {
                "func": "w_buy_art",
                "id": "buy_art",
                "param": {
                  "arts": ["120500","668954"],
                  "lfrom": 123405,
                  "pin": "qx1205"
                }
          }
  ]
}

Пример успешного ответа сервера

{
  "success": true,
  "time": "2020-06-15T14:16:56+03:00",
  "buy_art": {
    "success": true,
    "baskets": {
      "120500": "1373905601",
      "668954": "1373905612"
    }
  } 
}

Пример ответа сервера в случае ошибки

{
    "buy_art" : {
       "error_message" : "Attempt to buy TTS art",
       "success" : false,
       "time" : "2020-06-15T14:16:56+03:00",
       "error_code" : 101098
    },
    "success" : true,
    "time" : "2020-06-15T14:16:56+03:00"
 }