Ultrabux Surf API - Документация

🌊 Ultrabux Surf API

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

Базовый URL: https://ultrabux.ru/api/index.php
Формат данных: JSON
Поддержка методов: GET и POST

🔐 Аутентификация

📡 Методы API

💻 Примеры

🚫 Ошибки

🔐 Аутентификация

Все запросы к API требуют аутентификации с помощью API ключа. Ключ передается в параметре apikey.

⚠️ Важно: API является закрытым. Для получения API ключа необходимо обратиться в техническую поддержку Ultrabux.

POST

/api/index.php?action=create

Создание заказа серфинга

Создает новый заказ серфинга и автоматически активирует его (средства списываются сразу).

Параметры:

Параметр	Тип	Обязательный	Описание
`apikey`	string	Да	API ключ пользователя
`action`	string	Да	Должен быть `create`
`title`	string	Да	Заголовок заказа (макс. 60 символов)
`description`	string	Да	Описание заказа (макс. 60 символов)
`url`	string	Да	URL сайта для серфинга (с http:// или https://)
`tarif`	integer	Да	Тариф в секундах: 15, 20, 25, 30, 35, 40, 45, 50, 55, 60
`views`	integer	Да	Количество просмотров (мин. 1)

Успешный ответ:

{
    "success": true,
    "data": {
        "order_id": 71,
        "total_cost": 2.9,
        "views": 100,
        "price_per_view_advertiser": 0.029,
        "price_per_view_user": 0.019,
        "remaining_balance": 1749.879,
        "status": "active",
        "message": "Заказ создан и активирован."
    }
}

GET

/api/index.php?action=status

Получение статистики заказа

Возвращает информацию о заказе: количество просмотров, баланс, статус.

Параметры:

Параметр	Тип	Обязательный	Описание
`apikey`	string	Да	API ключ пользователя
`action`	string	Да	Должен быть `status`
`order_id`	integer	Да	ID заказа

Успешный ответ:

{
    "success": true,
    "data": {
        "order_id": 71,
        "total_views": 100,
        "completed_views": 15,
        "remaining_views": 85,
        "order_balance": 2.465,
        "user_balance": 1749.879,
        "status": "active",
        "price_per_view_advertiser": 0.029,
        "price_per_view_user": 0.019,
        "total_cost": 2.9
    }
}

GET

/api/index.php?action=balance

Получение баланса пользователя

Возвращает текущий баланс пользователя на рекламном счете.

Параметры:

Параметр	Тип	Обязательный	Описание
`apikey`	string	Да	API ключ пользователя
`action`	string	Да	Должен быть `balance`

Успешный ответ:

{
    "success": true,
    "data": {
        "username": "xakmika",
        "balance": 1749.879
    }
}

💻 Примеры использования

🌐 Создание заказа (GET запрос)

https://ultrabux.ru/api/index.php?
apikey=ВАШ_API_КЛЮЧ
&action=create
&title=Мой%20сайт
&description=Описание%20моего%20сайта
&url=https%3A%2F%2Fexample.com
&tarif=20
&views=100

🖥️ Создание заказа (POST cURL)

curl -X POST "https://ultrabux.ru/api/index.php" \
    -d "apikey=ВАШ_API_КЛЮЧ" \
    -d "action=create" \
    -d "title=Мой сайт" \
    -d "description=Описание сайта" \
    -d "url=https://example.com" \
    -d "tarif=20" \
    -d "views=100"

🐘 PHP пример

// Настройки API
$api_key = 'ВАШ_API_КЛЮЧ';
$url = 'https://ultrabux.ru/api/index.php';

// Данные для запроса
$data = [
    'apikey' => $api_key,
    'action' => 'create',
    'title' => 'Мой сайт',
    'description' => 'Описание сайта',
    'url' => 'https://example.com',
    'tarif' => 20,
    'views' => 100
];

// Создание cURL запроса
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Выполнение запроса
$response = curl_exec($ch);
curl_close($ch);

// Обработка ответа
$result = json_decode($response, true);

if ($result['success']) {
    echo "Заказ создан! ID: " . $result['data']['order_id'];
} else {
    echo "Ошибка: " . $result['error'];
}

🐍 Python пример

import requests

# Настройки API
api_key = 'ВАШ_API_КЛЮЧ'
url = 'https://ultrabux.ru/api/index.php'

# Данные для запроса
data = {
    'apikey': api_key,
    'action': 'create',
    'title': 'Мой сайт',
    'description': 'Описание сайта',
    'url': 'https://example.com',
    'tarif': 20,
    'views': 100
}

# Выполнение запроса
response = requests.post(url, data=data)
result = response.json()

if result['success']:
    print(f"Заказ создан! ID: {result['data']['order_id']}")
else:
    print(f"Ошибка: {result['error']}")

🚫 Коды ошибок

Сообщение об ошибке	Описание	Решение
`API key is required`	Не передан API ключ	Добавьте параметр `apikey`
`Invalid API key`	Неверный API ключ	Проверьте правильность ключа
`Обязательное поле отсутствует`	Не хватает обязательного параметра	Проверьте все обязательные параметры
`Неверный тариф`	Недопустимое значение тарифа	Используйте значения: 15, 20, 25, 30, 35, 40, 45, 50, 55, 60
`Неверный формат URL`	Некорректный URL	URL должен начинаться с http:// или https://
`Недостаточно средств на балансе`	Не хватает средств для создания заказа	Пополните баланс
`Заказ не найден или доступ запрещен`	Неверный ID заказа или нет доступа	Проверьте ID заказа и права доступа

Пример ответа с ошибкой:

{
    "success": false,
    "error": "Недостаточно средств на балансе. Требуется: 2.9 руб., доступно: 1.5 руб."
}