kattatzu/sbif

查询 SBIF (智利) API 的指标

1.3.0 2024-04-08 20:56 UTC

README

这是一个允许查询智利超级银行和金融机构(SBIF)API中指标值的库。您可以访问以下指标:

  • 美元
  • 欧元
  • UF
  • UTM
  • IPC

此外,您还可以访问智利银行信息

获取 API key

要使用 SBIF API,您需要在以下页面获取您的 APIKEY: http://api.sbif.cl/api/contactanos.jsp

安装

要安装库,请在控制台执行以下命令

composer require kattatzu/sbif

Laravel 中的安装和使用

独立使用

如果你的系统不使用 Laravel,你可以直接使用它

use Kattatzu/Sbif/Sbif;

$sbif = new Sbif('SBIF API KEY');
// o
$sbif = new Sbif;
$sbif->apiKey('SBIF API KEY');

echo $sbif->getDollar('2017-04-30');
//664.0

可用的指标

$date = Carbon::today();

$sbif->getDollar($date);
$sbif->getEuro($date);
$sbif->getUTM($date);
$sbif->getUF($date);
$sbif->getIPC($date);
// NOTA: El IPC solo tiene valor hasta el mes anterior

// Si no envias una fecha se toma la fecha actual
$sbif->getDollar();

您也可以动态查询

$sbif->getIndicator(Sbif::IND_EURO, $date);

可用的常量

Sbif::IND_UF
Sbif::IND_UTM
Sbif::IND_DOLLAR
Sbif::IND_EURO
Sbif::IND_IPC

您可以通过直接发送相应的端点来访问 SBIF 提供的其他数据(http://api.sbif.cl/que-es-api.html

var_dump($sbif->get("/resultados/2009/12/instituciones"));

object(stdClass){
    "DescripcionesCodigosDeInstituciones": [
        "0" => {
            "CodigoInstitucion": "001",
            "NombreInstitucion": "BANCO DE CHILE"
        },
        "1" => {
            "CodigoInstitucion": "014",
            "NombreInstitucion": "SCOTIABANK CHILE"
        },
        ...
    ]
}

银行信息

您可以查询 SBIF 提供的智利银行信息。

$info = $sbif->getInstitutionData('001');
echo $info->name;
// BANCO DE CHILE

您可以将信息作为数组获取

$info = $sbif->getInstitutionData('001')->toArray();
var_dump($info);
[
  "code" => "001",
  "name" => "BANCO DE CHILE",
  "swift_code" => "BCHI CL RM",
  "rut" => "97.004.000-5",
  "address" => "AHUMADA 251",
  "phone" => "(56-2) 653 11 11",
  "website" => "www.bancochile.cl",
  "public_contact" => "Pamela Valdivia",
  "public_address" => "Huérfanos 980, 8º Piso, Santiago",
  "public_phone" => "(56-2) 653 06 73",
  "branches" => 403,
  "employees" => 11426,
  "publication_date" => "2017-05-01",
  "cashiers" => 1412
]

要获取代码列表,可以使用 Institution 类

use Kattatzu\Sbif\Institution;

var_dump((new Institution)->getInstitutions());
[
  "001" => "Banco de Chile",
  "009" => "Banco Internacional",
  "014" => "Scotiabank Chile",
  "016" => "Banco de Credito E Inversiones",
  "028" => "Banco Bice",
  "031" => "HSBC Bank (chile)",
  "037" => "Banco Santander-chile",
  "039" => "Itaú Corpbanca",
  "049" => "Banco Security",
  "051" => "Banco Falabella",
  "053" => "Banco Ripley",
  "054" => "Rabobank Chile",
  "055" => "Banco Consorcio",
  "056" => "Banco Penta",
  "504" => "Banco BBVA",
  "059" => "Banco BTG Pactual Chile",
  "012" => "Banco del Estado de Chile",
  "017" => "Banco Do Brasil S.A.",
  "041" => "JP Morgan Chase Bank, N. A.",
  "043" => "Banco de la Nacion Argentina",
  "045" => "The Bank of Tokyo-mitsubishi UFJ",
  "060" => "China Construction Bank"
]

Laravel 中的安装和使用

使用 Composer 安装后,您需要在 config/app.php 文件中注册 ServiceProvider 和别名

'providers' => [
    ...
    Kattatzu\Sbif\Providers\SbifServiceProvider::class,
],
'aliases' => [
    ...
    'Sbif' => Kattatzu\Sbif\Facades\SbifFacade::class,
]

通过 Artisan 执行来发布配置文件

php artisan vendor:publish --provider="Kattatzu\Sbif\Providers\SbifServiceProvider"

现在您可以在 config/sbif.php 文件或 .env 文件中键 SBIF_API_KEY 中输入您的 API Key。

SBIF_API_KEY=xxxxxxxxxxxxxxxxxxxx

外观

现在您可以使用外观快速访问功能

Sbif::getDollar();
Sbif::getUTM('2017-06-30');
Sbif::getUF(Carbon::today());

辅助工具

您还可以使用辅助工具

sbif_dollar();
sbif_euro('2017-06-30');
sbif_utm(Carbon::yesterday());
sbif_uf(Carbon::now()->subMonth(1));
sbif_ipc();
sbif_institution('001')->name;
sbif_institutions();

请随时发送您的反馈或 pull-request 来改进这个库。

许可

MIT 许可证

版权(c)2017 José Eduardo Ríos

在此,免费授予任何获得此软件及其相关文档文件(“软件”)副本的任何人(“个人”)处理软件的权利,不受任何限制,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本的权利,并允许向软件提供的人这样做,前提是遵守以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

本软件按“原样”提供,不提供任何形式的保证,无论是明示的、暗示的、还是关于适销性、特定用途适用性或非侵权的保证。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任负责,无论这些责任是基于合同、侵权或其他原因,无论这些责任是否源于、因之而存在或与此软件或软件的使用或其他交易有关。