Merge pull request #337 from datagouv/feature/api-7216-mep-environnement-de-test-api-donnees-fondations-api-siaf

Implement SIAF fondations staging endpoint

Author: skelz0r

clients/node/api-entreprise/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.3.0
+
+### Added
+- `ministere_interieur.fondations(siren_or_siret_or_rnf)` — Données fondations
+  (SIAF / Ministère de l'Intérieur), `/v3/ministere_interieur/siaf/fondations/{siren_or_siret_or_rnf}`.
+  Available on staging only for now (endpoint in "prochainement" mode).
+
 ## 0.2.0
 
 ### Added

clients/node/api-entreprise/package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@api-gouv-dinum/api-entreprise",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Official Node.js client for API Entreprise v3",
   "type": "module",
   "main": "dist/index.cjs",

clients/node/api-entreprise/package.json

@@ -39,4 +39,18 @@ export class MinistereInterieur {
     })();
     return this.client.get(path, { params: { 'recipient': options.recipient, 'delegation_id': options.delegation_id, 'context': options.context, 'object': options.object } });
   }
+
+  /** Données fondations */
+  async fondations(siren_or_siret_or_rnf: string, options: { version?: number; recipient?: string; delegation_id?: string; context?: string; object?: string } = {}) {
+    const resolvedVersion = options.version ?? 3;
+    const path = (() => {
+      switch (resolvedVersion) {
+      case 3:
+        return `/v3/ministere_interieur/siaf/fondations/${siren_or_siret_or_rnf}`;
+        default:
+          throw new Error(`version ${resolvedVersion} not available for /ministere_interieur/siaf/fondations/{siren_or_siret_or_rnf}; supported: [3]`);
+      }
+    })();
+    return this.client.get(path, { params: { 'recipient': options.recipient, 'delegation_id': options.delegation_id, 'context': options.context, 'object': options.object } });
+  }
 }

clients/node/api-entreprise/src/resources/ministere_interieur.ts

@@ -6,6 +6,13 @@ adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-08-15
+
+### Added
+- `ministere_interieur.fondations(siren_or_siret_or_rnf)` — Données fondations
+  (SIAF / Ministère de l'Intérieur), `/v3/ministere_interieur/siaf/fondations/{siren_or_siret_or_rnf}`.
+  Available on staging only for now (endpoint in "prochainement" mode).
+
 ## [0.2.0] - 2026-05-19
 
 ### Added

clients/ruby/api_entreprise/CHANGELOG.md

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    api_entreprise (0.2.0)
+    api_entreprise (0.3.0)
       faraday (~> 2.0)
       faraday-retry (~> 2.0)
 
@@ -62,7 +62,7 @@ DEPENDENCIES
 
 CHECKSUMS
   addressable (2.9.0) sha256=7fdf6ac3660f7f4e867a0838be3f6cf722ace541dd97767fa42bc6cfa980c7af
-  api_entreprise (0.2.0)
+  api_entreprise (0.3.0)
   bigdecimal (4.1.1) sha256=1c09efab961da45203c8316b0cdaec0ff391dfadb952dd459584b63ebf8054ca
   crack (1.0.1) sha256=ff4a10390cd31d66440b7524eb1841874db86201d5b70032028553130b6d4c7e
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962

clients/ruby/api_entreprise/Gemfile.lock

@@ -39,6 +39,20 @@ def documents(siret_or_rna, version: nil, recipient: nil, delegation_id: nil, co
           end
         @client.get(path, params: { "recipient" => recipient, "delegation_id" => delegation_id, "context" => context, "object" => object }.compact)
       end
+
+      # Données fondations
+      # Logical endpoint: /ministere_interieur/siaf/fondations/{siren_or_siret_or_rnf}
+      # Versions available: [3] — default: 3
+      def fondations(siren_or_siret_or_rnf, version: nil, recipient: nil, delegation_id: nil, context: nil, object: nil)
+        path =
+          case version || 3
+          when 3
+          "/v3/ministere_interieur/siaf/fondations/#{siren_or_siret_or_rnf}"
+          else
+            raise ArgumentError, "version #{version.inspect} not available for /ministere_interieur/siaf/fondations/{siren_or_siret_or_rnf}; supported: [3]"
+          end
+        @client.get(path, params: { "recipient" => recipient, "delegation_id" => delegation_id, "context" => context, "object" => object }.compact)
+      end
     end
   end
 end

clients/ruby/api_entreprise/lib/api_entreprise/resources/ministere_interieur.rb

@@ -1,3 +1,3 @@
 module ApiEntreprise
-  VERSION = '0.2.0'.freeze
+  VERSION = '0.3.0'.freeze
 end

clients/ruby/api_entreprise/lib/api_entreprise/version.rb

@@ -153,6 +153,8 @@ shared:
   api_entreprise/v3_and_more/mi/unites_legales:
     - associations_donnees_protegees
     - associations_djepva
+  api_entreprise/v3_and_more/mi/siaf/fondations:
+    - fondations_mi_siaf
   api_entreprise/v3_and_more/mi/unites_legales_open_data:
     - associations
     - open_data

commons/data/authorizations.yml

@@ -26,6 +26,7 @@ shared:
       - api_entreprise_v3_mi_associations
       - api_entreprise_v3_mi_unites_legales
       - api_entreprise_v3_mi_unites_legales_open_data
+      - api_entreprise_v3_mi_siaf_fondations
       - api_entreprise_v3_dgddi_eori
       - api_entreprise_v3_infogreffe_mandataires_sociaux
       - api_entreprise_v3_infogreffe_extraits_rcs