GHI Public API v1.1
API synthétique et entièrement documentée – version 1.1 (FR/EN). Elle reste compatible avec les usages v1.0, tout en introduisant un format de réponse unifié et de nouveaux endpoints.
1. Aperçu (FR)
L’API v1.1 améliore la structure du snapshot, ajoute des statistiques globales
et introduit trois nouveaux endpoints : /metadata,
/network et /forecast.
Toutes les données proviennent du Sandbox Engine v0.4.2.
Principales améliorations
- Métadonnées unifiées dans toutes les réponses :
version,timestamp_utc,engine_version. - Statistiques globales (min / avg / max).
- Structure normalisée des régions.
- Nouveaux endpoints de métadonnées et réseau.
2. Endpoints
| Endpoint | Description |
|---|---|
/v1/ghi/snapshot |
Coûts de production régionaux + statistiques globales. |
/v1/ghi/history |
Série temporelle synthétique. |
/v1/ghi/regions |
Liste des régions disponibles. |
/v1/ghi/metadata |
Métadonnées globales. |
/v1/ghi/network |
Métriques réseau synthétiques. |
/v1/ghi/forecast |
Prévision synthétique du coût moyen. |
3. Structure exemple
{
"version": "1.1",
"timestamp_utc": "2025-12-09T12:00:00Z",
"engine_version": "0.4.2-sandbox",
"region_count": 3,
"regions": [
{
"region_id": "us",
"currency": "USD",
"min_cost_usd": 38000.0,
"avg_cost_usd": 42000.0,
"max_cost_usd": 50000.0
}
],
"global_min_cost_usd": 35000.0,
"global_avg_cost_usd": 42000.0,
"global_max_cost_usd": 52000.0
}4. Métadonnées communes
version— version de l’APItimestamp_utc— ISO 8601 UTCengine_version— version du moteur sandbox
5. Documentation technique
GHI Public API v1.1
Open, synthetic and fully documented API — version 1.1 (EN/FR). Backward-compatible with v1.0 while introducing a unified response format and new endpoints.
1. Overview (EN)
API v1.1 improves snapshot structure, adds global cost statistics and introduces:
/metadata, /network, /forecast.
All data powered by Sandbox Engine v0.4.2.
Main improvements
- Unified metadata fields.
- Global min / avg / max production cost.
- Normalized regional layout.
- New metadata & network endpoints.
2. Endpoints
| Endpoint | Description |
|---|---|
/v1/ghi/snapshot | Regional costs + global stats. |
/v1/ghi/history | Historical cost series. |
/v1/ghi/regions | Available regions. |
/v1/ghi/metadata | API & engine metadata. |
/v1/ghi/network | Network metrics. |
/v1/ghi/forecast | Cost forecast. |
3. Snapshot structure
{
"version": "1.1",
"timestamp_utc": "2025-12-09T12:00:00Z",
"engine_version": "0.4.2-sandbox",
"region_count": 3,
"regions": [...]
}4. Common metadata
versiontimestamp_utcengine_version