Управление проектами

Проекты в Rock Rim API представляют собой отдельные игры или приложения, привязанные к аккаунту.

Создание проекта

POST /api/v1/projects

Создает новый проект для аккаунта.

Требуется авторизация: x-account-key

Запрос

POST /api/v1/projects HTTP/1.1
Host: API_HOST
x-account-key: YOUR_ACCOUNT_KEY
Content-Type: application/json

{
  "account_id": "acc_1234567890",
  "name": "My Awesome Game",
  "bundle_id": "com.example.mygame",
  "platform": "mobile",
  "status": "active",
  "dlscheme": "myapp://",
  "config": {
    "sandbox_enabled": true,
    "webhook_url": "https://example.com/webhooks"
  }
}

Параметры запроса

Параметр	Тип	Обязательный	Описание
account_id	string	Да	ID аккаунта
name	string	Да	Название проекта
bundle_id	string	Да	Bundle ID приложения (com.example.app)
platform	string	Да	Платформа (mobile, web, desktop)
status	string	Нет	Статус проекта
dlscheme	string	Нет	Deep Link схема приложения для интеграции (например, myapp://)
config	object	Нет	Дополнительная конфигурация

Успешный ответ (200 OK)

{
  "id": "proj_abc123xyz",
  "account_id": "acc_1234567890",
  "name": "My Awesome Game",
  "bundle_id": "com.example.mygame",
  "platform": "mobile",
  "status": "active",
  "config": {
    "sandbox_enabled": true,
    "webhook_url": "https://example.com/webhooks"
  }
}

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

Параметр	Тип	Описание
id	string	Уникальный идентификатор проекта
account_id	string	ID аккаунта
name	string	Название проекта
bundle_id	string	Bundle ID приложения
platform	string	Платформа
status	string	Статус проекта
config	object	Конфигурация проекта

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

• 400 Bad Request - неверные параметры запроса
• 401 Unauthorized - неверный или отсутствующий x-account-key
• 500 Internal Server Error - внутренняя ошибка сервера

---

Обновление проекта

PUT /api/v1/projects

Обновляет информацию о проекте.

Требуется авторизация: Bearer токен

Запрос

PUT /api/v1/projects HTTP/1.1
Host: API_HOST
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "id": "proj_abc123xyz",
  "name": "My Awesome Game 2.0",
  "platform": "mobile",
  "config": {
    "sandbox_enabled": false,
    "webhook_url": "https://example.com/webhooks/v2"
  }
}

Параметры запроса

Параметр	Тип	Обязательный	Описание
id	string	Да	ID проекта для обновления
name	string	Нет	Новое название проекта
platform	string	Нет	Платформа
config	object	Нет	Обновленная конфигурация

Успешный ответ (200 OK)

{
  "id": "proj_abc123xyz",
  "account_id": "acc_1234567890",
  "name": "My Awesome Game 2.0",
  "bundle_id": "com.example.mygame",
  "platform": "mobile",
  "status": "active",
  "public_key": "pk_live_abc123xyz",
  "config": {
    "sandbox_enabled": false,
    "webhook_url": "https://example.com/webhooks/v2"
  }
}

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

Параметр	Тип	Описание
id	string	Идентификатор проекта
account_id	string	ID аккаунта
name	string	Название проекта
bundle_id	string	Bundle ID приложения
platform	string	Платформа
status	string	Статус проекта
public_key	string	Публичный ключ проекта для SDK
config	object	Конфигурация проекта

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

• 400 Bad Request - неверные параметры запроса
• 401 Unauthorized - неверный или отсутствующий токен
• 500 Internal Server Error - внутренняя ошибка сервера

---

Конфигурация проекта

Поле config позволяет хранить дополнительные настройки проекта:

{
  "config": {
    "sandbox_enabled": true,
    "webhook_url": "https://example.com/webhooks",
    "webhook_secret": "whsec_xxx",
    "allowed_currencies": ["RUB"],
    "custom_settings": {
      "feature_flags": {
        "new_checkout": true
      }
    }
  }
}

---

Платформы

Поддерживаемые значения для поля platform:

Значение	Описание
adroid	Мобильные приложения (iOS)
ios	Mобильные приложения (Android)

---

Связанные разделы

• Аккаунты - создание аккаунтов
• Магазины - создание магазинов для проекта
• Аутентификация - использование public_key