Початок роботи
Актуальні обмінні курси
Ендпоінт
live надає миттєвий доступ до поточних обмінних курсів для кількох валют, що дозволяє виконувати фінансові розрахунки в реальному часі та моніторити ринок.Конвертація валют
Ендпоінт
convert конвертує конкретні суми між валютами за найактуальнішими обмінними курсами — ідеально для фінансових застосунків і e-commerce платформ.Доступні символи валют
Ендпоінт
symbols надає повний каталог підтримуваних валют із детальними описами, що спрощує динамічний вибір валют і валідацію в застосунках.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 | Сервер був недоступний. |