vigicorp / sirene-api
Requires
- php: >=5.5
- ext-curl: *
- ext-json: *
- ext-mbstring: *
- guzzlehttp/guzzle: ^6.2
Requires (Dev)
- friendsofphp/php-cs-fixer: ~2.12
- phpunit/phpunit: ^4.8
- squizlabs/php_codesniffer: ~2.6
This package is auto-updated.
Last update: 2024-09-05 08:49:14 UTC
README
最后修改日期:2019年1月31日
Sirene API 提供自1973年Sirene登记册创建以来企业及机构信息,包括已关闭的单位。搜索可以是单一的、多标准的、音韵的,并且可以针对当前和历史数据。目前可用的服务查询法律实体(Siren)和机构(Siret)。即将推出:机构的先祖和继任者以及多年数据。
许可证
从 Sirene 数据库中提供的数据的重用受“开放许可/开放许可版本 2.0”许可协议的约束,该协议由协调国家行政机构及其公立机构行动的 Etalab 组织设计,以通过 interministériel data.gouv.fr 数据门户尽可能广泛地重用其公共信息。
Sirene 数据库包含个人数据,Insee 指出由此产生的法律义务。
- 这些数据的处理属于 1978 年 1 月 6 日第 78-17 号法律(修改后称为“信息技术和自由法”)的申报义务。
- 根据您对数据集的使用,您有责任考虑每个自然人最新发布的扩散状态。
实际上,根据商业法典第 A123-96 条
“任何自然人可以直接在其创建或修改的正式程序中,或者通过发送给国家统计局和经济发展研究所所长的一般信函,要求其登记册中的信息不得被授权用于除根据第 R.123-224 条授权的机构外,或用于任何目的,特别是商业目的的第三方。”
使用限制
Sirene API 的使用受每分钟 30 次查询的限制。
Insee 保留在必要时更改此限制的权利。
Sirene 登记册数据的更正权
商业法典第 A123-90 条规定,“1978 年 1 月 6 日法律第 39 条规定的访问权在国家统计局和经济发展研究所的地区主管处行使。”
临时 RGS (安全一般参考) 认证
Insee 总经理在听取安全认证委员会成员的意见后,证实“Sirene API”系统符合业主设定的目标,以适当地应对系统和信息保护的风险。
巴黎,2018年6月22日
国家统计局和经济发展研究所所长
委托
国家统计局和经济发展研究所秘书长
此 PHP 包由 Swagger Codegen 项目自动生成
- API 版本:3.6.3
- 构建包:io.swagger.codegen.languages.PhpClientCodegen
需求
PHP 5.5 及更高版本
安装 & 使用
Composer
要使用 Composer 安装绑定,请在 composer.json
中添加以下内容
{
"repositories": [
{
"type": "git",
"url": "https://github.com//.git"
}
],
"require": {
"/": "*@dev"
}
}
然后运行 composer install
手动安装
下载文件并包含 autoload.php
require_once('/path/to/SwaggerClient-php/vendor/autoload.php');
测试
运行单元测试
composer install
./vendor/bin/phpunit
入门
请按照安装流程进行操作,然后运行以下内容
<?php require_once(__DIR__ . '/vendor/autoload.php'); $apiInstance = new Sirene\Client\Api\EtablissementApi( // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`. // This is optional, `GuzzleHttp\Client` will be used as default. new GuzzleHttp\Client() ); $siret = "siret_example"; // string | Identifiant de l'établissement (14 chiffres) $date = "date_example"; // string | Date à laquelle on veut obtenir les valeurs des données historisées $champs = "champs_example"; // string | Liste des champs demandés, séparés par des virgules $masquer_valeurs_nulles = true; // bool | Masque (true) ou affiche (false, par défaut) les attributs qui n'ont pas de valeur try { $result = $apiInstance->findBySiret($siret, $date, $champs, $masquer_valeurs_nulles); print_r($result); } catch (Exception $e) { echo 'Exception when calling EtablissementApi->findBySiret: ', $e->getMessage(), PHP_EOL; } ?>
API端点文档
所有URI均相对于https://api.insee.fr/entreprises/sirene/V3
模型文档
授权文档
默认
- 类型: OAuth
- 流程: 隐式
- 授权URL: https://api.insee.fr/authorize
- 作用域: N/A