Endpunkte

Tarif-Endpunkte

Endpunkte zum Abrufen von Stromtarifdaten von Schweizer Energieversorgern.

Alle Tarife auflisten

Rufen Sie eine paginierte Liste aller Stromtarife mit optionaler Filterung und Sortierung ab.

GET/api/v1/tariffs

Abfrageparameter

Parameter	Typ	Beschreibung
`page`Optional	`integer`(Standard: 1)	Seitennummer für Paginierung
`limit`Optional	`integer`(Standard: 50)	Anzahl der Ergebnisse pro Seite (max: 100)
`organization_id`Optional	`uuid`	Nach Organisations-UUID filtern
`tariff_type`Optional	`string`	Nach Tariftyp filtern
`search`Optional	`string`	Nach Tarifname suchen
`sort_by`Optional	`string`(Standard: updated_at)	Sortierfeld: created_at, tariff_name, valid_from, updated_at
`sort_order`Optional	`string`(Standard: desc)	Sortierrichtung: asc oder desc

Beispiel

Anfragebash

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"

Beispielantwort

Antwortjson

{
  "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
  }
}

Einzelnen Tarif abrufen

Rufen Sie detaillierte Informationen zu einem bestimmten Tarif anhand seiner ID ab.

GET/api/v1/tariffs/:id

Pfadparameter

Parameter	Typ	Beschreibung
`id`Erforderlich	`uuid`	Die eindeutige UUID des Tarifs

Beispiel

Anfragebash

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

Beispielantwort

Antwortjson

{
  "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"
    }
  }
}

Tarifdatenstruktur

Das tariff_data-Objekt enthält detaillierte Preisinformationen in einem strukturierten Format. Dies umfasst Verbrauchstarife, zeitabhängige Preise und regulatorische Gebühren.

tariff_nameDer Anzeigename des Tarifs

tariff_typeArt des Tarifs (z. B. Standard, dynamisch, Solar)

valid_from / valid_toDie Gültigkeitsdauer des Tarifs (ISO-8601-Datum)

componentsPreisbestandteile wie Energiepreise, Netznutzungsgebühren und fixe Kosten