Created by Кристина Курашова, last modified by Ирина Лемешева on Jun 03, 2020

Позволяет получить все новости-уведомления пользователя за выбранный период, в том числе отправленные автоматически и ручные.

ID функции

r_push_list

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

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

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

d* – количество дней, за которое необходимо загрузить свежие новости. Например, если параметр имеет значение «7», то в список попадут только те новости, которые пользователь получил за последнюю неделю. Обязательный параметр, целое положительное число от 1 до 32;
old – необязательный параметр. Если он не указан, то в выдачу попадут только те новости, которые сформированы автоматически. Если же параметр присутствует в запросе и имеет значение «1», то в выдачу дополнительно попадут ещё и новости, подготовленные и отправленные вручную сотрудниками отдела маркетинга ЛитРес.

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

push_inbox* – массив, содержащий список всех новостей, полученных пользователем за указанное в запросе время. Для каждой новости будут возвращены следующие значения:

  • date* – дата, когда была сформирована новость (push-уведомление) в ISO-виде «YYYY-MM-DD hh:mm:ss», например, «2020-01-19 19:00:00»;
  • ticket_id* – ID тикета, по которому была сформирована новость (push-уведомление);
  • opened* – статус, показывающий, была ли ранее открыта и прочитана данная новость. Если вернулось значение «1», новость была открыта/прочитана, иначе – «0»;
  • xml* – полный текст новости, в формате xml. Содержит следующие значимые атрибуты:
    • message – общие параметры новости (push-уведомления):
      • engine – механизм, используемый для рассылки новости. Имеет значение только следующий значимый атрибут:
        • push – рассылка с помощью push-уведомлений;
      • engine_channel – канал рассылки. Содержит один из следующих значимых атрибутов:
        • ios-push-read – push-канал для приложения «Читай!» на платформе iOS;
        • ios-push-listen –  push-канал для приложения «Слушай!» на платформе iOS;
        • android-push-read – push-канал для приложения «Читай!» на платформе Android;
        • android-push-listen – push-канал для приложения «Слушай!» на платформе Android;
      • ticket – ID тикета, в рамках которого была сформирована новость (push-уведомление);
      • spam_pack_id – ID номер спам-рассылки; 
      • source_type – тип рассылки. Может принимать следующие значения:
        • posrednik – новость (push-уведомление) сформирована и отправлена через «Посредник» и является:
          • auto – автоматически сформированной;
          • raisin – сформированной вручную т. н. «изюм»;
        • handmade – новость (push-уведомление) сформирована вручную;
        • urgent_message – срочная новость;
    • obj_id – ID объекта, который будет показан в новости (push-уведомлении). Имеет значение только для новостей, у которых source_type=handmade. При этом учитывается тип новости:
      • type – тип новости. Возможные значения:
        • a – новость об авторе. При клике по новости переход на страницу автора;
        • b – новость о конкретном произведении (книге, аудиокниге). При клике по новости будет осуществлен переход на страницу книги;
        • c – новость о коллекции (подборке) произведений. При клике по новости будет осуществлен переход на страницу подборки;
        • ad – новость со ссылкой на какой-то, возможно, что и сторонний, сайт. При клике по новости будет осуществлен переход на страницу сайта.
    • forced-message – текстовая часть рассылки. Может отсутствовать у рассылок по конкретным книгам от «Посредника». Если присутствует в xml, обрабатывается при любом значении типа рассылки source_type. Содержит следующие значимые атрибуты:
      • subject – тема рассылки;
      • text – текст рассылки, в формате HTML;
      • beginning-sales – информация о начале продаж книги. Имеет значение, только для source_type=urgent_message;
      • lit_news – признак того, что это уведомление – результат выполнения библиотечного запроса: выдача книги пользователю, возврат книги в библиотеку, отказ в выдаче книги. Имеет значение, только для source_type=urgent_message;
    • arts – список книг, указанных в новости (опционально). Может отсутствовать. Блок arts важен, если source_type=posrednik и отсутствует содержимое атрибута forced-message либо source_type=urgent_message и forced-message содержит тег beginning-sales. Содержит следующие значимые атрибуты:
      • new_book – признак того, что книга является новинкой;
      • author-name-rodit – имя автора в родительном падеже. Может отсутствовать;
      • author-name-vinit – имя автора в винительном падеже. Может отсутствовать;
      • name – наименование книги.

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

Возможные ошибки описаны в статье «Обработка ошибок».

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

{
   "mobile_app": "1",
   "time": "2020-01-21T14:27:31+03:00",
   "sha": " ",
   "sid": " ",
   "requests": [
           {
                 "func": "r_push_list",
                 "id": "r_push_list",
                 "param": {
                 		"d": "7",
                 		"old": "1"
                 }
           }
}

Пример ответа сервера

{
    "success": true,
    "time": "2020-01-21T14:27:31+03:00",
    "r_push_list": {
        "success": true,
        "push_inbox": [
            {
                "date": "2020-01-13 16:10:46",
                "ticket_id": "6500141769",
                "opened": "0",
                "xml": "<message is-developer=\"0\"\n channel=\"5\"\n engine=\"push\"\n engine_channel=\"android-push-read\"\n libface=\"1030\"\n interest=\"100\"\n urgency=\"2\"\n annoyance=\"0\"\n ticket_created=\"2020-01-13 16:10:47\"\n xml_created=\"2020-01-13 16:10:48\"\n ticket=\"6500141769\"\n spam_pack_id=\"2259976\"\n user_channel_id=\"575509686\"\n source_type=\"auto\"\n urgent_msg=\"70841420\"\n spam_type=\"131\">\n  <recepient\n    annoy-lvl=\"100\"\n    name=\"402694214\"\n    first_name=\"\"\n    last_name=\"\"\n    full_name=\"\"\n    mail=\"sqloqerpljuk@dropmail.me\"\n    address=\"eWDLZwZSbys:APA91bHfln6mtt8SgdSOIxeFG5cyyx5PgutwDIgvZ0yx2Xb8o-gyqcZqTubsvDYFhs9FTWGoaeR6HAWim6CIifsAiHHWFG7fHi8VvXIEZOrZoTLrvE_GFkuua-vU1fgj2LOB_6_V_IjL\"\n    from=\"2020-01-13 16:10:46\"\n    to=\"2020-01-15 16:10:46\"\n    id=\"402694214\"\n    login=\"402694214\"\n    phone=\"79268536288\"\n    master_host=\"19\"\n    master_host_text=\"www.litres.ru\"\n    uilang=\"52\"\n    money_bonus=\"0\"\n    money_amount_full=\"0\"\n    money_amount=\"0\"\n     is-biblioteka-user=\"1\"></recepient><lib_face_currency currency=\"RUB\" rate=\"1.000000\" pre=\"\" post=\"₽\" updated=\"2019-01-11 13:47:46\" />\n    <forced-message>\n      <subject></subject><text></text>\n      <biblio_request libhouse_id=\"20927456\" id=\"250643327\" verdict=\"direct_loan\" puid=\"402694214\" approved=\"2020-01-13 16:10:43\" valid_till=\"2020-01-27 23:59:00\"    libhouse_host=\"biblio.litres.ru\" libhouse_name=\"Тест. биб. Мобильная\" />\n    </forced-message><arts>\n<new_book id=\"3954725\" name=\"Литературная газета №29 (6377) 2012\" filename=\"Litgazeta_2012_29.Fragment.pdf\" year-written=\"2012\" type=\"4\" chars=\"16\" authors-count=\"0\" genre_id=\"5242\" genre-title=\"культурология\" genres-count=\"1\" is_sequence=\"1\" sequence_id=\"116885\" sequence=\"Литературная газета 2012\" sequence_n=\"29\" adult=\"0\" price_type=\"1\" date-added=\"2012-10-03 23:56:28\" available=\"1\" rfc-date=\"Wed, 03 Oct 2012 23:56:28 +0300\" has_new=\"0\" cover=\"jpg\" cover_w=\"570\" cover_h=\"851\" release_file=\"5840565\" fileparts=\"0\" art_age=\"2657.718287037\" delivered=\"0\" release_size=\"584749\" allow_online_reading=\"0\" sell_open=\"2\" show_preview=\"4\" allow_drm=\"0\" public_domain=\"0\" free_access=\"0\" show_card=\"64\" can_preorder=\"0\" available_date=\"2012-10-03 23:52:45\" drm=\"0\" book-title=\"Литературная газета №29 (6377) 2012\" book_id=\"3954725\" uuid=\"031293a1-0bb8-11e2-86b3-b737ee03444a\" first_time_sale=\"2012-10-03 13:35:10\" preorder_show_fragment=\"0\" purchased=\"0\" in_basket=\"0\" promo_price=\"5.00\" cover_ratio=\"0.6698002\" mem=\"text\"  price=\"5.00\"><text_annotation><hidden><title-info>\n<genre>sci_culture</genre><genre>nonf_publicism</genre><genre>nonf_criticism</genre><genre>newspapers</genre><book-title>Литературная газета №29 (6377) 2012</book-title>\n<annotation><p>«Литературная газета» – старейшее российское издание, которое ведет свою историю с 1830 года. В наши дни «ЛГ» традиционно сохраняет серьезность и основательность, объективность в подходе к проблемам литературы и общества в целом, не теряет остроты мысли и глубины анализа. Вобрав в себя лучшие черты школы отечественной публицистики, сегодняшняя «ЛГ» заметно отличается от других изданий динамичностью, информативностью, высоким общекультурным и профессиональным уровнем.</p><p>Представляя на своих страницах все богатство российской и мировой литературы, «ЛГ» внимательно анализирует политические события в стране и мире. Вспоминает историю и знакомит с тенденциями развития общества, отражает самые заметные явления в искусстве, смеется вместе с читателями в знаменитом Клубе «12 стульев».</p></annotation>\n<date value=\"2012-01-01\">2012</date><lang>ru</lang><sequence name=\"Литературная газета 2012\" number=\"29\"/>\n<keywords>новости книжного рынка,книги и чтение,новости культуры и искусства,общественно-политическая жизнь</keywords>\n\n</title-info><document-info><author><nickname></nickname></author>\n<date value=\"2012-10-01\">2012-10-01</date>\n<id>031293a1-0bb8-11e2-86b3-b737ee03444a</id><version>1.0</version>\n<publisher><nickname>Литагент «Литературная газета»</nickname><id>414e4efe-086f-11e2-86b3-b737ee03444a</id><hub-id>2636105</hub-id></publisher>\n</document-info></hidden></text_annotation><basket-date date_add=\"2017-11-28\"/><supported-formats></supported-formats><file id=\"5840565\" mime=\"application/pdf\" size=\"584749\" filename=\"Litgazeta_2012_29.Fragment.pdf\" file_type=\"9\" chars=\"16\" pdf_page_size_x=\"355\" pdf_page_size_y=\"530\"/><file id=\"5840555\" mime=\"application/pdf\" size=\"2283328\" filename=\"Litgazeta_2012_29.pdf\" file_type=\"10\" chars=\"16\" pdf_page_size_x=\"355\" pdf_page_size_y=\"530\"/><art-collections></art-collections></new_book>\n</arts>\n</message>"
            },
            {
                "ticket_id": "6500142393",
                "date": "2020-01-13 16:13:55",
                "xml": "<message is-developer=\"0\"\n channel=\"5\"\n engine=\"push\"\n engine_channel=\"android-push-read\"\n libface=\"1030\"\n interest=\"100\"\n urgency=\"2\"\n annoyance=\"0\"\n ticket_created=\"2020-01-13 16:13:55\"\n xml_created=\"2020-01-13 16:13:59\"\n ticket=\"6500142393\"\n spam_pack_id=\"2259976\"\n user_channel_id=\"575509686\"\n source_type=\"auto\"\n urgent_msg=\"70841576\"\n spam_type=\"131\">\n  <recepient\n    annoy-lvl=\"100\"\n    name=\"402694214\"\n    first_name=\"\"\n    last_name=\"\"\n    full_name=\"\"\n    mail=\"sqloqerpljuk@dropmail.me\"\n    address=\"eWDLZwZSbys:APA91bHfln6mtt8SgdSOIxeFG5cyyx5PgutwDIgvZ0yx2Xb8o-gyqcZqTubsvDYFhs9FTWGoaeR6HAWim6CIifsAiHHWFG7fHi8VvXIEZOrZoTLrvE_GFkuua-vU1fgj2LOB_6_V_IjL\"\n    from=\"2020-01-13 16:13:55\"\n    to=\"2020-01-15 16:13:55\"\n    id=\"402694214\"\n    login=\"402694214\"\n    phone=\"79268536288\"\n    master_host=\"19\"\n    master_host_text=\"www.litres.ru\"\n    uilang=\"52\"\n    money_bonus=\"0\"\n    money_amount_full=\"0\"\n    money_amount=\"0\"\n     is-biblioteka-user=\"1\"></recepient><lib_face_currency currency=\"RUB\" rate=\"1.000000\" pre=\"\" post=\"₽\" updated=\"2019-01-11 13:47:46\" />\n    <forced-message>\n      <subject></subject><text></text>\n      <biblio_request libhouse_id=\"20927456\" id=\"250643652\" verdict=\"rejected\" puid=\"402694214\" requested=\"2020-01-13 16:13:38\" approved=\"2020-01-13 16:13:38\" reason=\"Причина отказа.\"   libhouse_name=\"Тест. биб. Мобильная\" libhouse_host=\"biblio.litres.ru\"  />\n    </forced-message><arts>\n<new_book id=\"3954745\" name=\"Литературная газета №31 (6379) 2012\" filename=\"Litgazeta_2012_31.Fragment.pdf\" year-written=\"2012\" type=\"4\" chars=\"16\" authors-count=\"0\" genre_id=\"5242\" genre-title=\"культурология\" genres-count=\"1\" is_sequence=\"1\" sequence_id=\"116885\" sequence=\"Литературная газета 2012\" sequence_n=\"31\" adult=\"0\" price_type=\"1\" date-added=\"2012-10-03 23:56:29\" available=\"1\" rfc-date=\"Wed, 03 Oct 2012 23:56:29 +0300\" has_new=\"0\" cover=\"jpg\" cover_w=\"570\" cover_h=\"851\" release_file=\"5840515\" fileparts=\"0\" art_age=\"2657.720486111\" delivered=\"0\" release_size=\"560322\" allow_online_reading=\"0\" sell_open=\"2\" show_preview=\"4\" allow_drm=\"0\" public_domain=\"0\" free_access=\"0\" show_card=\"64\" can_preorder=\"0\" available_date=\"2012-10-03 23:52:45\" drm=\"0\" book-title=\"Литературная газета №31 (6379) 2012\" book_id=\"3954745\" uuid=\"44609265-0bb8-11e2-86b3-b737ee03444a\" first_time_sale=\"2012-10-03 13:42:23\" preorder_show_fragment=\"0\" purchased=\"0\" in_basket=\"0\" promo_price=\"5.00\" cover_ratio=\"0.6698002\" mem=\"text\"  price=\"5.00\"><text_annotation><hidden><title-info>\n<genre>sci_culture</genre><genre>nonf_publicism</genre><genre>nonf_criticism</genre><genre>newspapers</genre><book-title>Литературная газета №31 (6379) 2012</book-title>\n<annotation><p>«Литературная газета» – старейшее российское издание, которое ведет свою историю с 1830 года. В наши дни «ЛГ» традиционно сохраняет серьезность и основательность, объективность в подходе к проблемам литературы и общества в целом, не теряет остроты мысли и глубины анализа. Вобрав в себя лучшие черты школы отечественной публицистики, сегодняшняя «ЛГ» заметно отличается от других изданий динамичностью, информативностью, высоким общекультурным и профессиональным уровнем.</p><p>Представляя на своих страницах все богатство российской и мировой литературы, «ЛГ» внимательно анализирует политические события в стране и мире. Вспоминает историю и знакомит с тенденциями развития общества, отражает самые заметные явления в искусстве, смеется вместе с читателями в знаменитом Клубе «12 стульев».</p></annotation>\n<date value=\"2012-01-01\">2012</date><lang>ru</lang><sequence name=\"Литературная газета 2012\" number=\"31\"/>\n<keywords>новости книжного рынка,книги и чтение,новости культуры и искусства,общественно-политическая жизнь</keywords>\n\n</title-info><document-info><author><nickname></nickname></author>\n<date value=\"2012-10-01\">2012-10-01</date>\n<id>44609265-0bb8-11e2-86b3-b737ee03444a</id><version>1.0</version>\n<publisher><nickname>Литагент «Литературная газета»</nickname><id>414e4efe-086f-11e2-86b3-b737ee03444a</id><hub-id>2636105</hub-id></publisher>\n</document-info></hidden></text_annotation><supported-formats></supported-formats><file id=\"5840515\" mime=\"application/pdf\" size=\"560322\" filename=\"Litgazeta_2012_31.Fragment.pdf\" file_type=\"9\" chars=\"16\" pdf_page_size_x=\"355\" pdf_page_size_y=\"530\"/><file id=\"5840525\" mime=\"application/pdf\" size=\"2025596\" filename=\"Litgazeta_2012_31.pdf\" file_type=\"10\" chars=\"16\" pdf_page_size_x=\"355\" pdf_page_size_y=\"530\"/><art-collections></art-collections></new_book>\n</arts>\n</message>",
                "opened": "0"
            }
        ],
        "success": true
    }