Типы данных аккаунтов

Персонажи и склад

Character

Поле	Тип	Описание
`id`	`ID!`	ID персонажа
`name`	`String!`	Имя
`level`	`Int!`	Уровень
`classId`	`Int!`	ID класса
`className`	`String!`	Название класса
`clanName`	`String`	Название клана
`online`	`Boolean!`	В сети
`karma`	`Int!`	Карма
`pkKills`	`Int!`	PK убийства
`pvpKills`	`Int!`	PvP убийства
`sex`	`Int!`	Пол
`lastAccess`	`DateTime`	Последний вход

CharacterItem

Поле	Тип	Описание
`id`	`ID!`	ID объекта инвентаря
`itemId`	`Int!`	ID типа предмета
`name`	`String!`	Название
`count`	`Int!`	Количество
`enchantLevel`	`Int!`	Заточка
`icon`	`String`	Иконка
`augmentation`	`String`	Аугментация
`attributes`	`JSON`	Атрибуты

CharacterOwner

Поле	Тип	Описание
`accountLogin`	`String!`	Логин игрового аккаунта
`character`	`Character!`	Персонаж

WarehouseItem

Поле	Тип	Описание
`id`	`ID!`	ID записи
`itemId`	`Int!`	ID предмета
`name`	`String!`	Название
`count`	`Int!`	Количество
`enchantLevel`	`Int!`	Заточка
`icon`	`String`	Иконка
`status`	`Int!`	Состояние выдачи
`giveType`	`Int!`	Способ выдачи
`createdAt`	`DateTime!`	Создано
`deliveredAt`	`DateTime`	Выдано

PurchaseResult

Поле	Тип	Описание
`message`	`String`	Сообщение
`item`	`WarehouseItem`	Выданный предмет
`balance`	`Float`	Обновлённый баланс
`bonusBalance`	`Float`	Обновлённый бонусный баланс
`warehouse`	`[WarehouseItem!]`	Обновлённый склад

ServiceResult

Поле	Тип	Описание
`message`	`String`	Сообщение
`balance`	`Float`	Обновлённый баланс
`bonusBalance`	`Float`	Обновлённый бонусный баланс

Игровой рынок

Все суммы и количества рынка представлены строками. Это сохраняет точность DECIMAL(20, 6) и больших игровых стеков на любом клиенте.

MarketplaceConfiguration

Поле	Тип	Описание
`enabled`	`Boolean!`	Рынок включён
`gameServerId`	`Int!`	Игровой сервер
`currency`	`MarketplaceCurrency!`	Валюта рынка
`version`	`String!`	Версия опубликованной конфигурации
`listingPolicy`	`MarketplaceListingPolicy!`	Общие правила объявлений
`paymentSources`	`[MarketplacePaymentSourceDefinition!]!`	Доступные источники оплаты
`sections`	`[MarketplaceSection!]!`	Разделы каталога
`sellerTiers`	`[MarketplaceSellerTier!]!`	Уровни продавцов
`transfers`	`MarketplaceTransferConfiguration!`	Переводы на основной баланс
`withdrawals`	`MarketplaceWithdrawalConfiguration!`	Вывод средств

MarketplaceListingPolicy

Поле	Тип	Описание
`sellerFeeBasisPoints`	`Int!`	Комиссия в базисных пунктах
`minimumPrice` / `maximumPrice`	`String!` / `String`	Диапазон цены
`maximumAssetsPerListing`	`Int!`	Активов в объявлении
`maximumActiveListings`	`Int!`	Активных объявлений
`itemModerationRequired`	`Boolean!`	Модерация предметов
`characterModerationRequired`	`Boolean!`	Модерация персонажей
`stackableItemsAllowed`	`Boolean!`	Стекаемые предметы
`augmentedItemsAllowed`	`Boolean!`	Аугментированные предметы
`attributedItemsAllowed`	`Boolean!`	Предметы с атрибутами
`sellerTiersEnabled`	`Boolean!`	Уровни продавцов

MarketplaceWithdrawalMethod

Поле	Тип	Описание
`code` / `name`	`String!`	Код и локализованное имя
`instructions`	`String`	Подсказка игроку
`destinationKind`	`String!`	Вид реквизитов
`destinationFields`	`[MarketplaceWithdrawalDestinationField!]!`	Опубликованная схема формы
`minimumAmount` / `maximumAmount`	`String`	Ограничения способа
`feeBasisPoints`	`Int`	Комиссия способа
`payoutCurrencyCode`	`String!`	Валюта выплаты

MarketplaceWithdrawalDestinationField.type: TEXT, EMAIL, PHONE или SELECT. Поле также содержит required, ограничения длины, безопасный pattern и варианты выбора.

MarketplaceCatalogConnection

Поле	Тип	Описание
`nodes`	`[MarketplaceCatalogOffer!]!`	Предложения страницы
`pageInfo`	`MarketplaceCursorPageInfo!`	Курсоры и наличие следующей страницы
`totalCount`	`Int!`	Всего опубликованных предложений
`filteredCount`	`Int!`	После фильтров

MarketplaceCatalogOffer

Поле	Тип	Описание
`id` / `listingId`	`ID!`	Предложение и объявление
`section`	`MarketplaceCatalogSection!`	Раздел
`saleMode`	`MarketplaceListingSaleMode!`	Режим продажи
`title` / `description`	`String`	Текст продавца
`unitPrice` / `currencyCode`	`String!`	Цена единицы и валюта
`availableUnits`	`String!`	Доступные единицы
`minimumPurchaseUnits` / `maximumPurchaseUnits`	`String!` / `String`	Границы покупки
`asset`	`MarketplaceCatalogAsset!`	Основной актив
`publishedAt`	`DateTime!`	Дата публикации

MarketplaceCatalogAsset

Поле	Тип	Описание
`type`	`MarketplaceAssetType!`	`ITEM` или `CHARACTER`
`itemId`	`ID`	ID предмета
`name`	`String!`	Текущее имя из распарсенного каталога либо имя персонажа
`additionalName`	`String`	Текущая подпись предмета
`gradeCode`	`String`	Текущий грейд
`icon` / `panelIcon`	`String`	Безопасные локальные изображения
`enchantLevel`	`Int!`	Заточка
`modifiers`	`MarketplaceItemModifiers`	Аугментация и атрибуты
`character`	`MarketplaceCharacterSnapshot`	Состояние персонажа при размещении
`characterInventory`	`[MarketplaceCharacterInventoryItem!]`	Состав персонажа с текущим оформлением предметов

Если предмет отсутствует в актуальном распарсенном каталоге проекта, операция завершается ошибкой целостности данных.

MarketplaceListing

Поле	Тип	Описание
`id`	`ID!`	Публичный ID
`section`	`MarketplaceListingSection!`	Раздел
`saleMode`	`MarketplaceListingSaleMode!`	Режим продажи
`publicationState`	`MarketplaceListingPublicationState!`	Публикация
`moderationState`	`MarketplaceListingModerationState!`	Модерация
`title` / `description`	`String`	Текст продавца
`sellerFeeBasisPoints`	`Int!`	Зафиксированная комиссия
`offers`	`[MarketplaceOffer!]!`	Варианты покупки
`publishedAt`	`DateTime!`	Публикация

MarketplaceOffer содержит точную цену, доступное количество, границы покупки и [MarketplaceOfferAsset!]! с количеством каждого актива на одну единицу.

MarketplaceViewer

Поле	Тип	Описание
`gameServerId`	`Int!`	Выбранный сервер сессии
`addonActive`	`Boolean!`	Дополнение принадлежит проекту и активно
`configurationPresent` / `configurationEnabled`	`Boolean!`	Состояние конфигурации
`currency`	`MarketplaceCurrency`	Валюта либо `null` без конфигурации
`capabilities`	`MarketplaceAccountCapabilities!`	Серверное решение для каждого действия
`restrictions`	`[MarketplaceRestrictionScope!]!`	Активные ограничения
`seller`	`MarketplaceSellerProfile!`	Лимиты, комиссия и уровень
`wallets`	`[MarketplaceWallet!]!`	Доступный и зарезервированный баланс
`statistics`	`MarketplaceAccountStatistics!`	Покупки, продажи и оборот

MarketplaceActionCapability состоит из allowed и причины блокировки reason. Возможные причины: ADDON_INACTIVE, CONFIGURATION_MISSING, CONFIGURATION_DISABLED, SELL_RESTRICTED, PURCHASE_RESTRICTED, PAYMENT_SOURCES_UNAVAILABLE, WITHDRAWAL_RESTRICTED, ACTIVE_LISTING_LIMIT_REACHED, NO_CANCELLABLE_LISTINGS, MAIN_BALANCE_TRANSFERS_DISABLED, EXTERNAL_WITHDRAWALS_DISABLED, WITHDRAWAL_METHODS_UNAVAILABLE.

MarketplaceSellerListing

Объявление продавца дополнительно возвращает:

endedReason, moderationNote и canCancel;
точные originalQuantity, reservedQuantity, deliveredQuantity, returnedQuantity для каждого актива;
totalUnits, reservedUnits, soldUnits, availableUnits для предложений;
publishedAt, suspendedAt, endedAt, createdAt, updatedAt.

MarketplaceOrder

Поле	Тип	Описание
`id`	`ID!`	Заказ
`role`	`MarketplaceOrderRole!`	Роль текущего игрока
`outcome`	`MarketplaceOrderOutcome!`	Итог заказа
`grossAmount`	`String!`	Общая сумма
`sellerFeeAmount`	`String!`	Комиссия
`sellerNetAmount`	`String!`	Зачисление продавцу
`payment`	`MarketplaceOrderPayment!`	Источник и состояние оплаты
`lines`	`[MarketplaceOrderLine!]!`	Состав, доставка и settlement
`completedAt` / `cancelledAt`	`DateTime`	Финальные даты

Оплата, доставка и settlement имеют независимые состояния. По одному общему status их определять нельзя.

MarketplaceWalletEntry

Поле	Тип	Описание
`type`	`MarketplaceWalletEntryType!`	Вид движения
`sourceType`	`MarketplaceWalletEntrySourceType!`	Источник
`sourceReference`	`ID`	Публичная ссылка на источник
`availableDelta` / `reservedDelta`	`String!`	Изменение частей баланса
`availableBalanceAfter` / `reservedBalanceAfter`	`String!`	Баланс после записи
`currencyCode`	`String!`	Валюта
`occurredAt`	`DateTime!`	Момент проводки

MarketplaceBalanceTransfer

Поле	Тип	Описание
`id`	`ID!`	Перевод
`state`	`MarketplaceBalanceTransferState!`	Жизненный цикл
`amount` / `currencyCode`	`String!`	Сумма и валюта
`completedAt` / `reversalStartedAt` / `reversedAt`	`DateTime`	Даты переходов
`createdAt` / `updatedAt`	`DateTime!`	Служебные даты

MarketplaceWithdrawal

Поле	Тип	Описание
`id`	`ID!`	Заявка
`method`	`MarketplaceWithdrawalMethodSummary!`	Способ
`reviewState`	`MarketplaceWithdrawalReviewState!`	Проверка
`payoutState`	`MarketplaceWithdrawalPayoutState!`	Выплата
`fundsState`	`MarketplaceWithdrawalFundsState!`	Средства
`sourceAmount` / `feeAmount` / `netSourceAmount`	`String!`	Расчёт в валюте рынка
`conversionRate` / `payoutAmount`	`String!`	Курс и выплата
`sourceCurrencyCode` / `payoutCurrencyCode`	`String!`	Валюты
`destinationPreview`	`String!`	Маскированные реквизиты
`reviewReasonCode` / `payoutReference`	`String`	Решение и ссылка выплаты
даты жизненного цикла	`DateTime`	Проверка, выплата, отмена

Результаты mutation

Тип	Назначение
`MarketplaceListingSubmission`	`requestId`, `listingId`, публикация, модерация и `offerIds`
`MarketplacePurchaseSubmission`	`requestId`, `orderId`, итог заказа, оплата и settlement
`MarketplaceListingCancellationSubmission`	Завершённое объявление и возвращённое количество
`MarketplaceBalanceTransferSubmission`	Созданный перевод, сумма и состояние
`MarketplaceWithdrawalSubmission`	Созданная заявка и полный расчёт выплаты

Состояния

Enum	Значения
`MarketplaceListingSaleMode`	`BUNDLE`, `INDIVIDUAL`, `CHARACTER`
`MarketplaceListingPublicationState`	`UNPUBLISHED`, `PUBLISHED`, `SUSPENDED`, `ENDED`
`MarketplaceListingModerationState`	`NOT_REQUIRED`, `PENDING`, `APPROVED`, `REJECTED`
`MarketplaceListingEndReason`	`SOLD_OUT`, `WITHDRAWN_BY_SELLER`, `REJECTED_BY_MODERATOR`, `REMOVED_BY_ADMIN`
`MarketplacePaymentSource`	`MAIN_BALANCE`, `MARKETPLACE_WALLET`
`MarketplaceOrderOutcome`	`OPEN`, `COMPLETED`, `CANCELLED`
`MarketplacePaymentState`	`PENDING`, `CAPTURED`, `REFUNDING`, `REFUNDED`, `CANCELLED`
`MarketplaceDeliveryState`	`PENDING`, `DELIVERING`, `DELIVERED`, `RETURNING`, `RETURNED`, `CANCELLED`
`MarketplaceSettlementState`	`PENDING`, `POSTED`, `REVERSING`, `REVERSED`, `CANCELLED`
`MarketplaceBalanceTransferState`	`PROCESSING`, `COMPLETED`, `REVERSING`, `REVERSED`
`MarketplaceWithdrawalReviewState`	`PENDING`, `APPROVED`, `REJECTED`
`MarketplaceWithdrawalPayoutState`	`NOT_STARTED`, `PROCESSING`, `PAID`, `CANCELLED`
`MarketplaceWithdrawalFundsState`	`RESERVED`, `SETTLED`, `RELEASED`, `FROZEN`

Персонажи и склад​

Character​

CharacterItem​

CharacterOwner​

WarehouseItem​

PurchaseResult​

ServiceResult​

Игровой рынок​

MarketplaceConfiguration​

MarketplaceListingPolicy​

MarketplaceWithdrawalMethod​

MarketplaceCatalogConnection​

MarketplaceCatalogOffer​

MarketplaceCatalogAsset​

MarketplaceListing​

MarketplaceViewer​

MarketplaceSellerListing​

MarketplaceOrder​

MarketplaceWalletEntry​

MarketplaceBalanceTransfer​

MarketplaceWithdrawal​

Результаты mutation​

Состояния​