API Authentication

Для взаимодействия с API используется стандартная токен-авторизация через API Key.

Все запросы должны отправляться в формате JSON (UTF-8) и содержать необходимые заголовки.

---

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

Если панель и API работают на поддомене app, точка входа выглядит так:

https://app.{ваш_домен}/api/v3

Примеры подстановки:

Если ваш домен: iexexchanger.com

Базовый URL API: https://app.iexexchanger.com/api/v3

---

Структура маршрутов

Публичные методы (без авторизации):

https://app.{ваш_домен}/api/v3/public/*

Пример:

https://app.{ваш_домен}/api/v3/public/rates.xml

Приватные методы (требуется токен):

https://app.{ваш_домен}/api/v3/private/*

Примеры:

https://app.{ваш_домен}/api/v3/private/health
https://app.{ваш_домен}/api/v3/private/account

---

Обязательные заголовки

Каждый запрос к приватному API должен содержать:

Accept: application/json
Content-Type: application/json; charset=utf-8
Authorization: Bearer YOUR_API_KEY

Где YOUR_API_KEY — API-ключ из личного кабинета пользователя.

---

Пример на Laravel HTTP Client (с учётом app-домена)

use Illuminate\Support\Facades\Http;

$apiKey  = 'YOUR_API_KEY'; // ваш API-ключ
$baseUrl = 'https://app.{ваш_домен}/api/v3/private';

$client = Http::baseUrl($baseUrl)
    ->withToken($apiKey)   // Authorization: Bearer {token}
    ->acceptJson()         // Accept: application/json
    ->asJson();            // Content-Type: application/json

Тест авторизации: /health

$response = $client->get('health');

if ($response->successful()) {
    dd('API OK', $response->json());
} else {
    dd('API ERROR', $response->status(), $response->body());
}