> ## 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.

## Коди відповідей і помилок

Якщо запити не вдаються, 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   | Сервер був недоступний.                                                                                           |