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

Digital Distribution Hub (1.0.0)

Введение

Digital Distribution Hub — новое решение Иксоллы, которое соединяет электронные и физические платежи через технологию push-платежей и e-commerce.

Данная документация включает в себя описание методов API для продуктов Внутриигровой магазин и Платежи. Используется два базовых URL-адреса:

  • https://store.xsolla.com/api для групп Общие, Каталог, Корзина и Заказ.
  • https://ps.xsolla.com для группы Уведомления.

Использование методов API из группы Каталог не требует авторизации.

Чтобы использовать методы API из групп Корзина и Заказ, вам необходимо создать токен.

Примечание

Данная документация не является полностью функциональным интерфейсом и представляет собой дизайн будущего API. В настоящее время вы можете использовать только методы из групп Каталог и Уведомления. Если вы хотите поделиться обратной связью, отправьте нам письмо по адресу techdoc@xsolla.com.
Скачать описание OpenAPI
index.json
index.yaml
Языки
Серверы
Mock server
https://xsolla.redocly.app/_mock/ru/api/digital-distribution-hub/
https://store.xsolla.com/api/

Корзина

Операции

Игровые ключи

Операции

Виртуальные предметы и валюта

Операции

Бандлы

Операции

Токен пользователя

Операции

Создание токена пользователя

Запрос

Проверяет существование пользователя в игре и создает токен с его данными.

Безопасность
basicAuth
Путь
project_idintegerобязательный

ID проекта.

Пример: 44056
Телоapplication/json
userobject(email-required)обязательный
user.​countrystring or null

Двухбуквенный код страны в верхнем регистре согласно ISO 3166-1 alpha-2.

Пример: "US"
user.​emailstringобязательный

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

Пример: "public_email@test.com"
user.​idstring or null

Уникальный идентификатор пользователя в игре.

Пример: "public_id"
user.​ipstring or null

IP-адрес пользователя.

Пример: "127.0.0.1"
user.​namestring or null

Имя пользователя в игре.

Пример: "Public name"
user.​phonestring or null

Номер телефона пользователя.

Пример: "+66-000-000-00-00"
curl -i -X POST \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/ru/api/digital-distribution-hub/v2/project/44056/distribution_hub/user/auth \
  -H 'Content-Type: application/json' \
  -d '{
    "user": {
      "country": "US",
      "email": "public_email@test.com",
      "id": "public_id",
      "ip": "127.0.0.1",
      "name": "Public name",
      "phone": "+66-000-000-00-00"
    }
  }'

Ответы

Токен пользователя успешно получен.

Телоapplication/json
tokenstring

Токен пользователя.

Ответ
application/json
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}

Уведомления

Операции

Заказ

Операции