vigicorp/sirene-api

1.0.0 2024-05-17 09:58 UTC

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

模型文档

授权文档

默认

作者