# Публичное API

Публичное API ARX Hosting позволяет внешним приложениям читать баланс, историю заказов и список серверов, а также создавать запросы на оплату — без входа через cookie-сессию сайта.

## 1. Аутентификация

Ключ создаётся в личном кабинете, в разделе «Настройки» → «API-ключи». Полный ключ показывается только один раз в момент создания — сохраните его сразу.

Каждый запрос должен содержать заголовок:

```
Authorization: Bearer arx_pk_ВАШ_КЛЮЧ
```

Базовый адрес API:

```
https://arx.duckserv.wtf/api/public/v1
```

## 2. Аккаунт

**GET /account** — данные текущего аккаунта.

```
GET /api/public/v1/account
Authorization: Bearer arx_pk_...
```

Ответ:

```
{
  "success": true,
  "account": {
    "login": "user1",
    "email": "user1@example.com",
    "balance": 1234.56,
    "currency": "RUB",
    "language": "ru"
  }
}
```

## 3. Заказы

**GET /orders** — история заказов (топ-апы и запросы на оплату), последние 100.

**GET /orders/{code}** — один заказ по коду.

**POST /orders** — создать новый запрос на оплату. Возвращает ссылку `/pay/{code}`, на которую нужно направить пользователя, чтобы он выбрал способ оплаты и заплатил.

```
POST /api/public/v1/orders
Authorization: Bearer arx_pk_...
Content-Type: application/json

{
  "amount": 500,
  "currency": "RUB",
  "description": "Пополнение баланса"
}
```

Ответ:

```
{
  "success": true,
  "code": "1234567890abcdef",
  "payUrl": "https://arx.duckserv.wtf/pay/1234567890abcdef"
}
```

Поле `currency` необязательно (по умолчанию `RUB`). Если ни один включённый способ оплаты не принимает указанную валюту, API вернёт ошибку.

## 4. Серверы

**GET /servers** — список серверов текущего аккаунта (только чтение — id, название, статус, тариф, цена, дата окончания). Управление серверами (запуск, остановка, удаление) доступно только из личного кабинета.

## 5. Валюты и языки

Каждый способ оплаты принимает свой список валют, настраиваемый администратором (например, Robokassa — рубли, Stripe — доллары и евро). Конвертации между валютами нет: заказ создаётся и оплачивается в той валюте, которая указана в запросе.

## 6. Ограничения

- Ключ действует до тех пор, пока не будет отозван в личном кабинете.
- Все действия выполняются от имени владельца ключа — доступ к чужим данным невозможен.
- Публичное API не заменяет личный кабинет: часть операций (управление серверами, тикеты поддержки и т.д.) доступна только там.