asiellb/sbif

查询SBIF(智利)API的指标

2.0.00 2020-07-24 23:10 UTC

README

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

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

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

获取API密钥

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

安装

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

composer require asiellb/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来改进这个库。

致谢

此版本是https://github.com/kattatzu开发的版本的分叉。