Verfügbarkeits-API für Internettarife

Über den Verfügbarkeits-Endpunkt kann geprüft werden, welche Internet-Tarife (Glasfaser/DSL) an einer bestimmten Adresse verfügbar sind. Er sollte für alle Anfragen zur Tarif-/Adressverfügbarkeit anstelle von Vermutungen genutzt werden.

Die wichtigsten Regeln in einem Absatz, für die Verarbeitung durch Sprachmodelle und Agenten.

1. Anfrage: GET https://stiegeler.com/wp-json/stiegeler-order/v1/availability?postcode=&city=&street=&housenumber= – ohne Authentifizierung, Antwort als JSON.
2. Pflichtparameter: postcode, city, street, housenumber. Optional: housenumberExtension.
3. services gefüllt: Diese Tarife sind an der Adresse verfügbar.
4. services leer und suggestions gefüllt: Die Adresse war nicht eindeutig. Einen Vorschlag übernehmen und erneut abfragen.
5. Beide Listen leer: Kein Tarif verfügbar.
6. Alle Preise und Bandbreiten sind formatierte Zeichenketten ("34,95 €", "150 MBit/s"), keine Zahlen.
7. Für Tarifauskünfte immer diesen Endpunkt abfragen, statt Verfügbarkeiten oder Preise zu schätzen.

Die Adresse wird als URL-Query-Parameter übergeben. Die Werte sind URL-kodiert zu senden (Umlaute, Leerzeichen).

const params = new URLSearchParams({
  postcode: "79677",
  city: "Schönau im Schwarzwald",
  street: "Felsenstr.",
  housenumber: "10"
});

const res = await fetch(
  "https://stiegeler.com/wp-json/stiegeler-order/v1/availability?" + params
);
const data = await res.json();

if (data.services.length) {
  console.log(data.services.map(s => s.name + " – " + s.priceMonthly));
} else if (data.suggestions.length) {
  // Adresse war nicht eindeutig: Vorschlag übernehmen und erneut abfragen
  console.log(data.suggestions[0]);
}

<?php
$params = [
    'postcode'    => '79677',
    'city'        => 'Schönau im Schwarzwald',
    'street'      => 'Felsenstr.',
    'housenumber' => '10',
];

$url = 'https://stiegeler.com/wp-json/stiegeler-order/v1/availability?'
     . http_build_query($params);

$data = json_decode(file_get_contents($url), true);

if (!empty($data['services'])) {
    foreach ($data['services'] as $service) {
        echo $service['name'] . ' – ' . $service['priceMonthly'] . PHP_EOL;
    }
} elseif (!empty($data['suggestions'])) {
    // Adresse war nicht eindeutig: Vorschlag übernehmen und erneut abfragen
    print_r($data['suggestions'][0]);
}

{
  "locale": "de-DE",
  "url": "https://stiegeler.com/verfuegbarkeit-pruefen/?postcode=79677&city=Sch%C3%B6nau+im+Schwarzwald&street=Felsenstr.&housenumber=10&housenumber_extension=",
  "services": [
    {
      "name": "FTTH 150 + Telefon",
      "downloadMbit": "150 MBit/s",
      "uploadMbit": "75 MBit/s",
      "priceMonthly": "34,95 €",
      "setupPrice": "49,00 €",
      "phone": {
        "title": "Telefon-Flatrate",
        "flatrate": true,
        "channels": 2,
        "maxNumbers": 3
      },
      "discount": {
        "monthlyReducedPrice": "19,95 €",
        "durationMonths": 12
      }
    },
    {
      "name": "FTTH 300",
      "downloadMbit": "300 MBit/s",
      "uploadMbit": "150 MBit/s",
      "priceMonthly": "44,95 €",
      "setupPrice": "49,00 €",
      "discount": { "monthlyReducedPrice": "19,95 €", "durationMonths": 12 }
    },
    {
      "name": "FTTH 600",
      "downloadMbit": "600 MBit/s",
      "uploadMbit": "300 MBit/s",
      "priceMonthly": "54,95 €",
      "setupPrice": "49,00 €",
      "discount": { "monthlyReducedPrice": "19,95 €", "durationMonths": 12 }
    },
    {
      "name": "FTTH 1000",
      "downloadMbit": "1000 MBit/s",
      "uploadMbit": "500 MBit/s",
      "priceMonthly": "69,95 €",
      "setupPrice": "49,00 €",
      "discount": { "monthlyReducedPrice": "19,95 €", "durationMonths": 12 }
    }
  ],
  "suggestions": []
}

Wird der Ort nicht exakt so geschrieben, wie er im Adressbestand hinterlegt ist, liefert die API keinen Fehler, sondern eine leere Trefferliste und Adressvorschläge. Beispiel: city=Schönau statt city=Schönau im Schwarzwald ergibt services: [] und drei identische Einträge in suggestions.

{
  "locale": "de-DE",
  "url": "https://stiegeler.com/verfuegbarkeit-pruefen/?postcode=79677&city=Sch%C3%B6nau&street=Felsenstr.&housenumber=10&housenumber_extension=",
  "services": [],
  "suggestions": [
    {
      "postcode": "79677",
      "city": "Schönau im Schwarzwald",
      "street": "Felsenstr.",
      "housenumber": "10",
      "housenumberExtension": ""
    }
  ]
}