Перейти к основному содержимому

Получение отзывов приложения

Метод позволяет получить список всех последних отзывов для вашего приложения или получить отдельно взятый отзыв.

Ограничения:

  • по умолчанию на каждой странице отображается по 20 отзывов, вы можете отображать до 100 отзывов на странице, указав значение в параметре size;
  • совместно использовать параметры пагинации и фильтрации по 1 отзыву — нельзя (либо пагинация с указанием пары параметров page и size либо id);
  • если пользователь отредактировал отзыв, то признак редактирования отзыва (edited) принимает значение true;
  • по умолчанию сортировка производится по дате публикации отзыва (параметр updatedAt) от наиболее свежего отзыва.

Параметры взаимодействия​

GET

https://public-api.rustore.ru/public/v1/application/{packageName}/comment?id={id}&page={number}&size={size}

АтрибутТипОбязателенРасположениеОписаниеПример
Public-TokenstringДаheaderТокен доступа к API RuStore.N/A
packageNamestringДаpathНаименование пакета приложения. Максимальная длина – 50 символов.com.myapp.example
idnumberНетqueryid конкретного отзыва. Задается при необходимости получить конкретный отзыв.743103
pagenumberНетqueryНомер страницы. Начинается с 0.0
sizenumberНетqueryКоличество отзывов на странице. По умолчанию — 20, максимально — 100.100

Параметры ответа​

АтрибутТипОбязателенОписаниеПример
codestringДаКод ответа.error/OK
messagestringНетРасшифровка кода ответа.N/A
timestamptimestamptzДаВремя ответа.2022-07-08T13:24:41.8328711+03:00
body{}objectДаN/AN/A

body{}​

АтрибутТипОбязателенОписаниеПример
packageNamestringДаНаименование пакета приложения.com.myapp.example
appIdnumberДаid приложения.385727
commentIdnumberДаid отзыва.697535
userNamestringДаИмя автора отзыва.Irina
appRatingnumberДаОценка отзыва.4
commentStatusstringДаСтатус отзыва.PUBLISHED
commentDatetimestamptzДаДата, когда был оставлен отзыв.2024-10-16 06:59:50.050
commentTextstringДаТекст отзыва.Все супер!
likeCounternumberДаКоличество лайков отзыву от других пользователей витрины RuStore.5
dislikeCounternumberДаКоличество дизлайков отзыву от других пользователей витрины RuStore.0
updatedAttimestamptzДаДата прохождения модерации и публикации отзыва в системе.2022-10-14 15:14:33.033
appVersionNamestringДаВерсия приложения.1.4
editedbooleanДаПризнак редактирования отзыва• True — отзыв редактировался и был перезаписан.
• False — отзыв не редактировался.
NewcommentDateIsotimestamptzДаДата, когда был оставлен отзыв, в формате ISO.2024-10-16T06:57:34.17Z
NewupdatedAtIsotimestamptzДаДата, когда был оставлен отзыв, в формате ISO.2024-10-16T06:58:01.016568Z

Пример запроса для вывода множества отзывов​

curl --location 'https://public-api.rustore.ru/public/v1/application/ru.voonsh.push/comment' \
--header 'Content-Type: application/json' \
--header 'Public-Token: eyJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiUlNBLU9BRVAtMjU2In0.jrVl3YT99saGcata9fzN6_QpoQhDsv8oBUAj9p7UyR4Ga5PM8TTyNbpTKIeaIjGoEfsBMJx0aw0b7fhD04bhSp7SWEBKGBTzFCjwOZ5_Fcezq0-NOMSayzoPttYa7oMRDiqNS4rqaUOdCUrf9qlDyEq3BGoUYCaUD7L5399l51NhSLrWpoPx1l4ZLVJ5bjlhiCoPAtLArnulq5LBoDk3naoGaRHabkkffcucEjA45uNpCsq0fx77Lk4YhN30LOccyImE-O8fUq8YryMWv4w-ZmWjax1oT9nRgO95r9EYG7Gwdekg2ILuWnsofiMXME8t1EiEuUmDpNTEyS9SiUMRwQ.lSJBV1mSmHehuqVs.8pXL_GRLwEJgIWZOzkklKgrsGKKJrG9kv1AIdD0PPU8KtsY8GVAc5xaaQgeyjSsJiSUvma_IohAaIBwP-tjTRxrnzVinMhKAJMCbiMIVqsQSRDB5j_mf91nTNewQkWJwB33Rvxd9F4Tt-Tk-1QKALU8tAT_HXAI.v9WBgx8T6yFDpeMrjw-ECQ'

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

{
    "code": "OK",
    "message": null,
    "body": [
        {
            "packageName": "ru.voonsh.push",
            "appId": 227169215,
            "commentId": 2142370751,
            "userName": "Saber",
            "appRating": 5,
            "commentStatus": "PUBLISHED",
            "commentDate": "2024-10-16 06:59:50.050",
            "commentText": "Good App, nice done!",
            "likeCounter": 0,
            "dislikeCounter": 0,
            "updatedAt": "2023-06-13 11:59:50.050",
            "appVersionName": "1.4",
            "edited": false,
            "updatedAtIso": "2024-10-16T06:58:01.016568Z",
            "commentDateIso": "2024-10-16T06:57:34.17Z"
        },
        {
           "packageName": "ru.voonsh.push",
            "appId": 227169215,
            "commentId": 1981700287,
            "userName": "Виктор",
            "appRating": 5,
            "commentStatus": "PUBLISHED",
            "commentDate": "2024-10-16 06:59:50.050",
            "commentText": "Отличное приложение! ;#",
            "likeCounter": 0,
            "dislikeCounter": 0,
            "updatedAt": "2023-04-27 18:55:30.030",
            "appVersionName": "1.3",
            "edited": false,
            "updatedAtIso": "2024-10-16T06:58:01.016568Z",
            "commentDateIso": "2024-10-16T06:57:34.17Z"
        },
        {
            "packageName": "ru.voonsh.push",
            "appId": 227169215,
            "commentId": 1981699775,
            "userName": "Григорий",
            "appRating": 5,
            "commentStatus": "PUBLISHED",
            "commentDate": "2024-10-16 06:59:50.050",
            "commentText": "Отличное приложение!",
            "likeCounter": 1,
            "dislikeCounter": 0,
            "updatedAt": "2023-04-27 18:55:30.030",
            "appVersionName": "1.3",
            "edited": false,
            "updatedAtIso": "2024-10-16T06:58:01.016568Z",
            "commentDateIso": "2024-10-16T06:57:34.17Z"
        },
        {
            "packageName": "ru.voonsh.push",
            "appId": 227169215,
            "commentId": 237681343,
            "userName": "Ибрагим",
            "appRating": 5,
            "commentStatus": "PUBLISHED",
            "commentDate": "2024-10-16 06:59:50.050",
            "commentText": "Повышаем ДАУ)))",
            "likeCounter": 1,
            "dislikeCounter": 1,
            "updatedAt": "2022-09-16 18:06:39.039",
            "appVersionName": null,
            "edited": false,
            "updatedAtIso": "2024-10-16T06:58:01.016568Z",
            "commentDateIso": "2024-10-16T06:57:34.17Z"
        }
    ],
    "timestamp": "2023-06-15T07:32:55.505979576+03:00"
}

Пример запроса для вывода конкретного отзыва​

curl --location 'https://public-api.rustore.ru/public/v1/application/ru.voonsh.push/comment?id=1981699775' \
--header 'Content-Type: application/json' \
--header 'Public-Token: eyJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiUlNBLU9BRVAtMjU2In0.h635qF_TZc43287jXQVImu_-o4eVFQwrQYe2WnjbywC_KUC4oX6W3ssyPWzlAugd2RELbVCTk1wiDdKwPIbkOJC_HdF0yAmnPg0PRxwyfCHblRuccuuEg_l6sKY1Fqrh6kH3D5N2i_HnDei-hTusAvHR333ZstAK73dc-4Ecn24jb1XyBsdg0_KddKaRpEjTMSudIV6rdpBNMlQRUyQufrP2RMXK5Kc_0gY0iA-tazQoOJmK4xstHmuFbSBx3J6oN5QIlYonx0LZ6ABf2fD0O1E7LFsVUMd2bOdLYg5id5bTRXKd238iB5snmPhGJJN3d6v8xdoV5TdOMGPvjO0A5A.-mSbEMAvEglyEOJu.eKxraHkohwEcn3cG4glUBnwypjnapol4WnwhQGyKe-TDq9TGNj9CO4hnXGh4UPSRI55w73pJwSCuDe7LfsQ8zqBVjirT_HXypowHsWBwvBG-6rwSRvhZsad2YY8wHTZeXOddVynWnESoKAnXIdImafEbIWN1Hik.VJ-b1KxDxMrgJTz_Vuul2Q'

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

{
    "code": "OK",
    "message": null,
    "body": [
        {
            "packageName": "ru.voonsh.push",
            "appId": 227169215,
            "commentId": 1981699775,
            "userName": "Григорий",
            "appRating": 5,
            "commentStatus": "PUBLISHED",
            "commentDate": "2024-10-16 06:59:50.050",
            "commentText": "Отличное приложение!",
            "likeCounter": 1,
            "dislikeCounter": 0,
            "updatedAt": "2024-10-16 06:58:16.016",
            "appVersionName": "1.3",
            "edited": false,
            "updatedAtIso": "2024-10-16T06:58:01.016568Z",
            "commentDateIso": "2024-10-16T06:57:34.17Z"
        }
    ],
    "timestamp": "2023-06-15T07:13:16.309841987+03:00"
}