跳到主要内容

获取应用评论

该方法允许获取您应用的所有最新评论列表，或获取单条评论。

限制条件：

  • 默认情况下，每页显示 20 条评论；您可以通过在 size 参数中指定数值，每页最多显示 100 条评论；
  • 不能同时使用分页参数和单条评论过滤参数（要么使用包含 page 和 size 参数对的分页，要么使用 id）；
  • 如果用户编辑了评论，则评论编辑标志 (edited) 的值为 true；
  • 默认情况下，按评论发布日期 (updatedAt 参数) 从最新到最旧进行排序。

交互参数​

GET

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

属性类型是否必填位置描述示例
Public-Tokenstring是headerRuStore API 的访问令牌。N/A
packageNamestring是path应用的包名。 最大长度为 50 个字符。com.myapp.example
idnumber否query特定评论的 id。 在需要获取特定评论时指定。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 — 评论未被编辑。
commentDateIsotimestamptz是ISO 格式的留下评论的日期。2024-10-16T06:57:34.17Z
updatedAtIsotimestamptz是ISO 格式的留下评论的日期。2024-10-16T06:58:01.016568Z
devResponsesarray否开发者对评论的回复。[{"text": "Спасибо за отзыв!", "createdAt": "2024-10-16T07:00:00Z"}]
deviceInfoobject否设备信息（设备、型号、操作系统版本）。{"device": "Samsung", "model": "SM-G973F", "osVersion": "Android 12"}
appVersionCodenumber否应用版本 (version_code)。42

输出多条评论的请求示例​

curl --location 'https://public-api-m.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",
            "devResponses": [
                {
                    "text": "Спасибо за оценку!",
                    "createdAt": "2024-10-16T07:00:00Z"
                }
            ],
            "deviceInfo": {
                "device": "Xiaomi",
                "model": "Mi 11",
                "osVersion": "Android 13"
            },
            "appVersionCode": 42
        },
        {
            "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",
            "devResponses": [],
            "deviceInfo": {
                "device": "Google",
                "model": "Pixel 6",
                "osVersion": "Android 14"
            },
            "appVersionCode": 41
        },
        {
            "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",
            "devResponses": [],
            "deviceInfo": null,
            "appVersionCode": 41
        },
        {
            "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",
            "devResponses": [],
            "deviceInfo": null,
            "appVersionCode": null
        }
    ],
    "timestamp": "2023-06-15T07:32:55.505979576+03:00"
}

获取特定评论的请求示例​

curl --location 'https://public-api-m.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",
            "devResponses": [
                {
                    "text": "Рады, что вам нравится!",
                    "createdAt": "2024-10-16T08:00:00Z"
                }
            ],
            "deviceInfo": {
                "device": "Samsung",
                "model": "SM-G973F",
                "osVersion": "Android 12"
            },
            "appVersionCode": 41
        }
    ],
    "timestamp": "2023-06-15T07:13:16.309841987+03:00"
}