kattatzu / sbif
查询 SBIF (智利) API 的指标
Requires
- guzzlehttp/guzzle: ^7.8.1
- nesbot/carbon: ^3.2.4
README
这是一个允许查询智利超级银行和金融机构(SBIF)API中指标值的库。您可以访问以下指标:
- 美元
- 欧元
- UF
- UTM
- IPC
此外,您还可以访问智利银行信息。
获取 API key
要使用 SBIF API,您需要在以下页面获取您的 APIKEY: http://api.sbif.cl/api/contactanos.jsp
安装
要安装库,请在控制台执行以下命令
composer require kattatzu/sbif
独立使用
如果你的系统不使用 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
在此,免费授予任何获得此软件及其相关文档文件(“软件”)副本的任何人(“个人”)处理软件的权利,不受任何限制,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本的权利,并允许向软件提供的人这样做,前提是遵守以下条件
上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。
本软件按“原样”提供,不提供任何形式的保证,无论是明示的、暗示的、还是关于适销性、特定用途适用性或非侵权的保证。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任负责,无论这些责任是基于合同、侵权或其他原因,无论这些责任是否源于、因之而存在或与此软件或软件的使用或其他交易有关。