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

Все запросы к UnoAPI требуют аутентификации через API-ключ в заголовке Authorization.

Получение API-ключа

Зарегистрируйтесь в личном кабинете
Перейдите в раздел API Keys
Нажмите Create New Key
Скопируйте ключ — он будет показан только один раз

Использование ключа

Передавайте API-ключ в заголовке Authorization с префиксом Bearer:

Authorization: Bearer YOUR_API_KEY

Примеры

# В командной строке
curl https://proxy.unoapi.ru/v1/ipinfo/8.8.8.8 \
  -H "Authorization: Bearer uno_live_abc123..."

# Или через переменную окружения
export UNOAPI_KEY="uno_live_abc123..."
curl https://proxy.unoapi.ru/v1/ipinfo/8.8.8.8 \
  -H "Authorization: Bearer $UNOAPI_KEY"

// Через переменную окружения (рекомендуется)
const UNOAPI_KEY = process.env.UNOAPI_KEY;

const response = await fetch('https://proxy.unoapi.ru/v1/ipinfo/8.8.8.8', {
  headers: {
    'Authorization': `Bearer ${UNOAPI_KEY}`
  }
});

// Создание переиспользуемого клиента
class UnoAPIClient {
  private apiKey: string;
  private baseUrl = 'https://proxy.unoapi.ru';

  constructor(apiKey: string) {
    this.apiKey = apiKey;
  }

  async request(path: string, options?: RequestInit) {
    return fetch(`${this.baseUrl}${path}`, {
      ...options,
      headers: {
        'Authorization': `Bearer ${this.apiKey}`,
        ...options?.headers,
      },
    });
  }
}

const client = new UnoAPIClient(process.env.UNOAPI_KEY!);

import os
import requests

# Через переменную окружения (рекомендуется)
UNOAPI_KEY = os.environ['UNOAPI_KEY']

response = requests.get(
    'https://proxy.unoapi.ru/v1/ipinfo/8.8.8.8',
    headers={'Authorization': f'Bearer {UNOAPI_KEY}'}
)

# Создание сессии для переиспользования
class UnoAPIClient:
    def __init__(self, api_key: str):
        self.session = requests.Session()
        self.session.headers['Authorization'] = f'Bearer {api_key}'
        self.base_url = 'https://proxy.unoapi.ru'

    def get(self, path: str, **kwargs):
        return self.session.get(f'{self.base_url}{path}', **kwargs)

    def post(self, path: str, **kwargs):
        return self.session.post(f'{self.base_url}{path}', **kwargs)

client = UnoAPIClient(os.environ['UNOAPI_KEY'])

package main

import (
  "net/http"
  "os"
)

// Через переменную окружения (рекомендуется)
var apiKey = os.Getenv("UNOAPI_KEY")

// Создание клиента с автоматической аутентификацией
type UnoAPIClient struct {
  apiKey  string
  baseURL string
  client  *http.Client
}

func NewClient(apiKey string) *UnoAPIClient {
  return &UnoAPIClient{
    apiKey:  apiKey,
    baseURL: "https://proxy.unoapi.ru",
    client:  &http.Client{},
  }
}

func (c *UnoAPIClient) Do(req *http.Request) (*http.Response, error) {
  req.Header.Set("Authorization", "Bearer "+c.apiKey)
  return c.client.Do(req)
}

Формат ключа

API-ключи имеют следующий формат:

Префикс	Среда	Описание
`uno_live_`	Production	Боевой ключ с тарификацией
`uno_test_`	Sandbox	Тестовый ключ (ограниченные данные)

Безопасность

Что НЕ делать

❌ Не передавайте ключ в URL (query параметры)
❌ Не включайте в клиентский JavaScript
❌ Не коммитьте в git-репозиторий
❌ Не отправляйте в чатах и email

Ошибки аутентификации

401 Unauthorized

Возвращается если:

Заголовок Authorization отсутствует
Формат заголовка неверный (нет Bearer)
API-ключ недействителен или отозван

{
  "error": "unauthorized",
  "message": "Invalid or missing API key"
}

403 Forbidden