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

Получение списка приложений

Метод позволяет получить приложения, доступные владельцу аккаунта, в котором создается приватный ключ.

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

GET

https://public-api.rustore.ru/public/v1/application

АтрибутТипОбязателенРасположениеОписаниеПример
Public-TokenstringДаheaderТокен доступа к Public API Rustore
paginationbool
• Нет
• Да, если используете continuationToken и pageSize		pathФлаг включения пагинации.
По умолчанию false.
Если необходимо настроить пагинацию, измените на true
continuationTokenstringНетpathЕсли список доступов продолжается на другой странице, API включает в ответ элемент continuationToken. Используйте значение, полученное в результате выполнения предыдущего запросаNzk0MjQ3Mzcw
pageSizestring
• Нет
• Да, если pagination — true		pathКоличество приложений на одной страницеПо умолчанию: 20
Минимум: 1
Максимум: 1000
appNamestringНетpathПараметр для поиска по appNameName
appPackagestringНетpathПараметр для поиска по package_namecom.myapp.example
orderFieldsstringНетpathПараметр для сортировкиДоступные значения:
• appId — id приложения
• appName — наименование приложения
• appStatus — статус приложения
• appVerUpdatedAt — дата обновления версии
sortDirectionsstring
• Нет
• Да, если указан параметр orderFields		pathВозможности сортировкиДоступные значения:
• ASC
• DESC

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

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

body{}​

АтрибутТипОбязательностьОписаниеПример
content[]massiveДаМассив, содержащий список доступных приложений
pageSizestringДаРазмер страницыКоличество приложений для текущей пагинации
continuationTokenstringНетЕсли список приложений продолжается на другой странице, API включает в ответ элемент continuationTokenNzk0MjQ3Mzcw

body.content[]​

АтрибутТипОбязательностьОписаниеПример
activePricenumberНетЦена120
appIdnumberДаИдентификатор приложения478564
appNamestringДаНазвание приложенияПриложение1
appStatusstringНетСтатус приложенияВозможные знaчения:
• ACTIVE – текущая опубликованная версия ;
• PARTIAL_ACTIVE – версия опубликована на заданный процент пользователей;
• READY_FOR_PUBLICATION – версия одобрена модератором;
• PUBLISHED – версия опубликована;
• PREVIOUS_ACTIVE – предыдущая активная версия;
• ARCHIVED – версия находится в архиве;
• REJECTED_BY_MODERATOR – версия отклонена модератором;
• TAKEN_FOR_MODERATION – версия находится на модерации;
• MODERATION – версия ожидает действий от модератора;
• AUTO_CHECK – автоматическая проверка антивирусом Касперского;
• AUTO_CHECK_FAILED – автоматическая проверка не пропустила APK;
• NOT_PUBLISHED – версия не опубликована;
• DRAFT – черновик версии;
• DELETED_DRAFT – черновик удалён;
• REJECTED_BY_SECURITY – версия отклонена со стороны ИБ
appVerUpdatedAttimestamptzНетДата обновления версии2024-03-11T12:23:55.596998+03:00
companyNamestringДаНазвание компанииКомпания пример
deviceTypestringНетТип устройстваMOBILE
iconUrlstringНетСсылка на иконку приложенияСсылка на иконку
packageNamestringДаНаименование пакета приложенияcom.myapp.example
paidboolНетПлатное или нетtrue/false
shortDescriptionstringНетКраткое описаниеКраткое описание приложения
versionCodenumberНетКод версии1
versionNamestringНетНазвание версии1.0

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

codemessageОписаниеДействия
400pageSize must be not null in range [1,1000]Неправильно указано значение pageSizeПроверьте, что вы верно указали значение параметра pageSize
400Invalid request contentВведены неверные данные параметровПроверьте, что вы верно указали значения параметров
400if one of orderFields sortDirections is not null other param should be also not nullНе хватает данных по сортировкеПараметры orderFields и sortDirections должны указываться вместе

Пример запроса​

сurl --location 'https://public-api.rustore.ru/public/v1/application' \
--header 'Content-Type: application/json' \
--header 'Public-Token: {YOURtoken}'

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

{
  "code": "OK",
  "message": "OK",
  "body": {
    "content": [
      {
        "appId": 478564,
        "packageName": "com.example.myapplicativfsdvf",
        "appName": "компания пример",
        "iconUrl": "https://platform-s3.dev.rustore.devmail.ru/rustore-public-dev1/apk/478564/content/ICON/f6b95c5f-6c45-4359-988e-a9fd759c9416.jpg",
        "appStatus": "PUBLISHED",
        "versionName": "1.0",
        "versionCode": 1,
        "companyName": "companyName",
        "shortDescription": "Краткое описание",
        "appVerUpdatedAt": "2024-03-11T12:23:55.596998+03:00",
        "activePrice": 0,
        "paid": false,
        "deviceType": "MOBILE"
      }
    ],
    "continuationToken": "TlRFeE56VXcuLi4u"
  },
  "timestamp": "2024-09-04T13:38:39.906714473+03:00"
}