Endpoint

Endpoint tariffe

Endpoint per recuperare dati tariffari elettrici dai fornitori di energia svizzeri.

Elencare tutte le tariffe

Recupera un elenco paginato di tutte le tariffe elettriche con filtraggio e ordinamento opzionali.

GET/api/v1/tariffs

Parametri di query

Parametro	Tipo	Descrizione
`page`Opzionale	`integer`(Predefinito: 1)	Numero di pagina per la paginazione
`limit`Opzionale	`integer`(Predefinito: 50)	Numero di risultati per pagina (max: 100)
`organization_id`Opzionale	`uuid`	Filtra per UUID organizzazione
`tariff_type`Opzionale	`string`	Filtra per tipo di tariffa
`search`Opzionale	`string`	Cerca per nome tariffa
`sort_by`Opzionale	`string`(Predefinito: updated_at)	Campo di ordinamento: created_at, tariff_name, valid_from, updated_at
`sort_order`Opzionale	`string`(Predefinito: desc)	Direzione ordinamento: asc o desc

Esempio

Richiestabash

curl -X GET "https://www.strompreise-schweiz.ch/api/v1/tariffs?page=1&limit=10&sort_by=updated_at&sort_order=desc" \
  -H "x-api-key: YOUR_API_KEY"

Esempio di risposta

Rispostajson

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-20T14:45:00Z",
      "tariff_data": {
        "tariff_name": "Basic Household Tariff 2024",
        "tariff_type": "standard",
        "valid_from": "2024-01-01",
        "valid_to": "2024-12-31",
        "currency": "CHF",
        "components": {
          "energy": {
            "high_tariff": 0.2456,
            "low_tariff": 0.1834
          },
          "grid_usage": {
            "high_tariff": 0.0892,
            "low_tariff": 0.0654
          },
          "fees": {
            "base_fee_monthly": 8.50,
            "meter_fee_monthly": 2.00
          }
        }
      },
      "organization": {
        "name": "Example Energy Provider AG",
        "dso_number": "CH-123"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 156,
    "total_pages": 16
  }
}

Ottenere singola tariffa

Recupera informazioni dettagliate su una tariffa specifica tramite il suo ID.

GET/api/v1/tariffs/:id

Parametri del percorso

Parametro	Tipo	Descrizione
`id`Obbligatorio	`uuid`	L'UUID unico della tariffa

Esempio

Richiestabash

curl -X GET "https://www.strompreise-schweiz.ch/api/v1/tariffs/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: YOUR_API_KEY"

Esempio di risposta

Rispostajson

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "tariff_data": {
      "tariff_name": "Basic Household Tariff 2024",
      "tariff_type": "standard",
      "valid_from": "2024-01-01",
      "valid_to": "2024-12-31",
      "currency": "CHF",
      "components": {
        "energy": {
          "high_tariff": 0.2456,
          "low_tariff": 0.1834,
          "unit": "CHF/kWh"
        },
        "grid_usage": {
          "high_tariff": 0.0892,
          "low_tariff": 0.0654,
          "unit": "CHF/kWh"
        },
        "fees": {
          "base_fee_monthly": 8.50,
          "meter_fee_monthly": 2.00,
          "unit": "CHF"
        }
      }
    },
    "organization": {
      "name": "Example Energy Provider AG",
      "dso_number": "CH-123"
    },
    "source": {
      "url": "https://example-provider.ch/tariffs/2024",
      "description": "Official tariff document"
    }
  }
}

Struttura dati tariffa

L'oggetto tariff_data contiene informazioni dettagliate sui prezzi in un formato strutturato. Questo include tariffe di consumo, prezzi orari e commissioni normative.

tariff_nameNome visualizzato della tariffa

tariff_typeTipo di tariffa (es. standard, dinamica, solare)

valid_from / valid_toPeriodo di validità della tariffa (formato data ISO 8601)

componentsComponenti dei prezzi inclusi i costi dell'energia, le tariffe di rete e gli oneri fissi