> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Введение

> API обменных курсов Cleariflow обеспечивает конвертацию валют в реальном времени через современный RESTful JSON-интерфейс с поддержкой более 80 мировых валют, актуальных курсов и мгновенной конвертации.

## Начало работы

<Card title="Актуальные обменные курсы" icon="activity" href="exchange-rates/live">
  Эндпоинт `live` предоставляет мгновенный доступ к текущим обменным курсам по нескольким валютам для финансовых расчётов и мониторинга рынка в реальном времени.
</Card>

<Card title="Конвертация валют" icon="arrow-left-right" href="exchange-rates/convert">
  Эндпоинт `convert` конвертирует конкретные суммы между валютами по актуальным курсам — идеально для финансовых приложений и e-commerce.
</Card>

<Card title="Доступные символы валют" icon="circle-dollar-sign" href="exchange-rates/symbols">
  Эндпоинт `symbols` предоставляет полный каталог поддерживаемых валют с подробными описаниями для динамического выбора и проверки валют в приложениях.
</Card>

### REST-архитектура

API обменных курсов следует принципам REST: предсказуемые URL, ориентированные на ресурсы, и стандартные HTTP-коды статуса для интеграции и обработки ошибок.

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

Все соединения с API защищены TLS 1.2 или выше для целостности и конфиденциальности данных.

### Версионирование API

API обменных курсов сохраняет обратную совместимость через версионирование; сейчас работает версия 1 с запланированными улучшениями.

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

API-ключ — единственные учётные данные для доступа к API обменных курсов. Каждый сервис Cleariflow требует уникальный ключ для изолированного и безопасного доступа.

## Коды ответов и ошибок

При неудаче API возвращает структурированные JSON-ошибки с кодами и описаниями для эффективной диагностики.

| Code | Type                  | Details                                                                                                    |
| ---- | --------------------- | ---------------------------------------------------------------------------------------------------------- |
| 200  | OK                    | Всё прошло как ожидалось.                                                                                  |
| 204  | OK                    | Нет данных о местоположении для переданного IP.                                                            |
| 400  | Bad request           | Некорректный запрос.                                                                                       |
| 401  | Unauthorized          | Запрос не принят. Обычно из-за отсутствующего или неверного API-ключа.                                     |
| 422  | Quota reached         | Запрос прерван из-за недостатка API-кредитов. (Бесплатные тарифы)                                          |
| 429  | Too many requests     | Запрос прерван из-за достижения лимита запросов в секунду. На бесплатных тарифах — до 1 запроса в секунду. |
| 500  | Internal server error | Запрос не выполнен из-за ошибки на стороне сервера.                                                        |
| 503  | Service unavailable   | Сервер был недоступен.                                                                                     |