Aaio - Документация
Вернуться на сайт
  • 😇Приветствие
  • 😱Нашли проблему?
  • 📍IP Адреса сервиса
  • ⚛️Готовые CMS модули и SDK
    • WHMCS 5.x-8.x
    • Opencart 2.3.x
    • Opencart 3.x
    • DLE Billing
    • Billmanager 6
    • WooCommerce — Плагин для WordPress
    • Xenforo 2.1.0+
    • Python 3 SDK
    • Typescript SDK
    • Java SDK
  • 🤑Прием платежей
    • 🔥Создание заказа запросом (Рекомендуем)
      • Методика формирования подписи
    • 💩Создание заказа переходом на форму (Устаревшее)
      • Методика формирования подписи
      • Пример формы на PHP
      • Пример получения ссылки на PHP
      • Пример получения ссылки на Python
    • Редирект клиента с формы оплаты
    • Оповещение об оплате заказа
      • Методика формирования подписи
      • Пример обработчика на PHP
  • 💸Вывод средств
    • Оповещение о выполнении либо отмене вывода
      • Методика формирования подписи
      • Пример обработчика на PHP
  • 🕵️API
    • Получение баланса
    • Вывод средств
    • Курс валют при выводе средств
    • Банки для вывода средств на СБП
    • Информация о заявке на вывод средств
    • Информация о заказе
    • Доступные методы для вывода средств
    • Доступные методы для создания заказа
  • Прочее
    • Кодовые названия методов пополнения
    • Кодовые названия методов вывода
Powered by GitBook
On this page
  • Запрос
  • Заголовки
  • Примеры ответа
  • Готовые примеры запроса
  1. API

Получение баланса

API для бизнеса

Last updated 2 months ago

Запрос

GET / POST https://aaio.so/api/balance

Заголовки

Accept: application/json * X-Api-Key: {api_key} *

Определения

{api_key} - Ключ API из раздела с разрешениями: Получение методов пополнения и вывода * - обязательные заголовки. Без них Вы не сможете получить корректный ответ.

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

Формат ответа application/json

{
    "type": "success",
    "balance": 1592.03, // Доступный основной баланс к выводу
    "referral": 346.49, // Доступный реферальный баланс для вывода на основной баланс
    "hold": 0 // Замороженный баланс
}

Пользовательские коды ошибок - 400, 401, 429 Серверные коды ошибок - 500, 503

{
  "type": "fail",
  "code": "400",
  "message": "message"
}

Если код ответа другой, то возможна проблема на стороне сервера API. Рекомендуем учитывать такие ситуации в коде.

Готовые примеры запроса

curl -X 'GET' \
'https://aaio.so/api/balance' \
-H 'accept: application/json' \
-H 'x-api-key: API_KEY'
<?php
$api_key = ''; // Ключ API из раздела https://aaio.so/cabinet/api

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://aaio.so/api/balance');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    	'Accept: application/json',
	'X-Api-Key: ' . $api_key
]);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 15); // Таймаут подключения к нашему серверу
curl_setopt($ch, CURLOPT_TIMEOUT, 60); // Таймаут обработки запроса

$result = curl_exec($ch); // Ответ
$http_code = curl_getinfo($ch, CURLINFO_RESPONSE_CODE); // Код ответа

if (curl_errno($ch)) {
	die('Connect error:' . curl_error($ch)); // Вывод ошибки соединения
}
curl_close($ch);

if(!in_array($http_code, [200, 400, 401])) {
	die('Response code: ' . $http_code); // Вывод неизвестного кода ответа
}

$decoded = json_decode($result, true); // Парсинг результа. На выходе получаем массив данных

if(json_last_error() !== JSON_ERROR_NONE) {
	die('Не удалось пропарсить ответ');
}

if($decoded['type'] == 'success') {
	print_r($decoded); // Вывод результата
} else {
	die('Ошибка: ' . $decoded['message']); // Вывод ошибки
}
import requests, sys
from requests.exceptions import ConnectTimeout, ReadTimeout

url = 'https://aaio.so/api/balance'
api_key = '' # Ключ API из раздела https://aaio.so/cabinet/api

headers = {
    'Accept': 'application/json',
    'X-Api-Key': api_key
}

try:
    response = requests.post(url, headers=headers, timeout=(15, 60))
except ConnectTimeout:
    print('ConnectTimeout') # Не хватило времени на подключение к сайту
    sys.exit()
except ReadTimeout:
    print('ReadTimeout') # Не хватило времени на выполнение запроса
    sys.exit()

if(response.status_code in [200, 400, 401]):
    try:
        response_json = response.json() # Парсинг результата
    except:
        print('Не удалось пропарсить ответ')
        sys.exit()

    if(response_json['type'] == 'success'):
        print(response_json) # Вывод результата
    else:
        print('Ошибка: ' + response_json['message']) # Вывод ошибки
else:
    print('Response code: ' + str(response.status_code)) # Вывод неизвестного кода ответа
🕵️
https://aaio.so/business/api/keys