README

Rate.in.ua (乌克兰汇率) 是一个聚合网站，汇集了乌克兰所有最流行的银行和兑换所。

目前我们提供超过20个城市货币汇率的信息；

通过我们的API，您可以

• 获取上述所有服务中的货币汇率信息；
• 了解每个服务的平均汇率；
• 获取所选日期段的货币历史汇率；

获取特定城市的货币汇率

为了简单获取汇率，建议安装我们的composer包。该包没有依赖，并且使用简单。

安装composer包

composer require kurstoday/api

安装后，您可以使用Kurstoday类实例与API交互；

<?php
use kurstoday\Kurstoday; // подключаем класс

$api = new Kurstoday; // создаем экземпляр класса

卢茨克兑换所汇率获取示例

<?php $lutskService = $api->getService('lutsk'); ?>

以下列出完整城市列表

• 乌克兰银行
• 基辅
• 卢茨克
• 哈尔科夫
• 利沃夫
• 第聂伯罗彼得罗夫斯克
• 敖德萨
• 卢布林
• 伊万诺-弗兰科夫斯克
• 苏梅
• 日托米尔
• 扎波罗热
• 尼古拉耶夫
• 波尔塔瓦
• 切尔诺夫策
• 切尔卡瑟
• 赫尔松
• 卡缅卡什尔斯基
• 科韦尔
• 沃伦
• 克里维里希

我们得到一个数组，其中包含服务描述和嵌套数组 exchangers，其中描述了兑换所（银行）

[
    [serviceId] => 3
    [serviceName] => Lutsk
    [exchangers] => [ // обменники (банки)
        [0] => [
            [id] => 1
            [serviceId] => 3
            [name] => Kantor
            [website] => http://kantor.com.ua
            [image] => https://kurstoday.com/images/exchangers/kantor.png // логотип обменника (банка)
            [background] => #00A1D8
            [border] => #969696
            [slug] => kantor
            [rates] => [ // описание курсов валют
                [exchangerId] => 72
                [updateTime] => 1588581967 // время в формате timestamp (Europe/Kiev) последнего изменения курса
                [usd] => [
                    [buy] => 27.00
                    [sel] => 27.10
                ],
                [eur] => [
                    [buy] => 29.20
                    [sel] => 29.40
                ],
                ... и так дальше ...
            ],
        ],
        ... и так дальше ...
    ]
]

哈尔科夫兑换所平均汇率获取示例

<?php $kharkivAverage = $api->getAverage('kharkiv'); ?>

我们得到一个包含哈尔科夫货币汇率的数组

[
    [usd] => [
        [buy] => 26.78
        [sel] => 26.88
    ],
    [eur] => [
        [buy] => 28.81
        [sel] => 29.00
    ],
    [rur] => [
        [buy] => 01.93
        [sel] => 00.36
    ],
    ... и так дальше ...
]