
Mini-Lektion 16 von 30 · Daten und KI anbinden
Öffne die fertige Suche
Für wen ist das gedacht?
Für alle, die aktuelle Informationen eines anderen Dienstes auf einer Website zeigen möchten. Die bereitgestellte Seite und ein Programmierassistent übernehmen den Browsercode; du kannst dich auf das Ergebnis konzentrieren.
Frage einen Wert beim Dienst ab, statt eine feste Zahl in die Seite zu schreiben.
Ziel dieser Lektion
- Frage ein echtes öffentliches Repository ab.
- Zeige mit einem Programmierassistenten ein nützliches zusätzliches Ergebnis.
- Unterscheide ein nicht gefundenes Repository von einem nicht verfügbaren Dienst.
Erklärung, ausgearbeitetes Beispiel und Übung
Bevor du beginnst
Das bereitgestellte Workshopmaterial, Internetzugang und eine lokale HTTP-Vorschau, die dein Programmierassistent starten kann. Dieses Beispiel liest öffentliche GitHub-Repositories ohne privaten Token; Dienstverfügbarkeit und Ratenlimits gelten trotzdem.
Prüfe deine Vorkenntnisse
Diese Fähigkeiten sind hilfreich; ein Kursabschluss wird nicht erzwungen. Beherrschst du sie schon, starte hier. Sonst öffne die Vorbereitung. Eine eigene bestehende Website ist dank der Startdateien nicht nötig.
- So erstellst du deine erste persönliche Website
Erstelle aus einer bereitgestellten Vorlage eine Vorstellung, einen Projektbereich und eine Kontaktmöglichkeit.
Geschätzte Dauer: 14–26 Min.
Schätzungen für die mitgelieferten Startdateien bei bereits eingerichteten Konten und Werkzeugen. Einrichtung, Deployment-Warteschlangen sowie E-Mail- und DNS-Wartezeiten kommen hinzu. Nicht authentifizierte GitHub-Anfragen teilen sich ein IP-basiertes Kontingent; wiederholte Tests können es ausschöpfen.
Die Idee verstehen
Lass deinen Assistenten den bereitgestellten Ordner public über HTTP starten. Nutze das Vorlagenbeispiel octocat / Hello-World und betätige die Suchschaltfläche.
Vergleiche zurückgegebene Repositoryidentität und Anzahl mit dem damaligen Dienstergebnis. Hinterlege keine alte Zahl fest, als wäre sie aktuell.
Ein konkretes Beispiel
Eine im Seitentext gespeicherte Sternanzahl kann sich bei Änderungen am Repository nicht aktualisieren.
Starte die bereitgestellte öffentliche Repository-Suchseite über lokales HTTP. Erhalte die vorhandene sichere Textdarstellung und füge keinen privaten Token in Browserdateien ein. Hilf mir, ein echtes Repository, ein fehlendes Repository und eine fehlgeschlagene Dienstanfrage zu testen. Ergänze danach die dokumentierte Anzahl offener Einträge und hilf mir beim Vergleich mit der API-Antwort. Übernimm Codeänderungen für mich.Dateien für diesen Schritt
Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.
Selbst ausprobieren
Welches Repository hast du abgefragt, und welches Ergebnis zeigte die laufende Seite tatsächlich?
Ausgearbeitete Lösung anzeigen
Veranschaulichendes Abfrageprotokoll mit erfundener Anzahl: „Zu meinem Testzeitpunkt fragte ich octocat / Hello-World ab. Die Seite lieferte octocat/Hello-World und 12 Sterne; sichtbare Identität und Anzahl entsprachen der geprüften Antwort.“ Die 12 ist eine erfundene Messung für dieses Beispiel, keine aktuelle Tatsache über dieses Repository.
Sternzahlen können sich ändern. Dein Protokoll braucht die tatsächlich beobachtete Anzahl und Testzeit. Hat der Dienst nicht geantwortet, beschreibe diesen Zustand, statt diese Beispielzahl einzusetzen.
Was eine gute Antwort enthält
- Benennt den tatsächlich angefragten öffentlichen Eigentümer und das Repository sowie die zurückgegebene Identität.
- Dokumentiert beobachtete Anzahl und Zeitpunkt oder einen genauen Dienstfehler, ohne einen Beispielwert fest einzubauen.
So funktioniert es (optional)
Zeige Daten eines anderen Dienstes
Lade Namen, Beschreibung und Sterneanzahl eines öffentlichen Repositorys von GitHub.
Eine API ist eine festgelegte Möglichkeit für Software, Daten oder eine Aktion anzufordern. Hier fragt deine Website bei GitHub ein Repository ab und erhält JSON statt einer HTML-Seite.
Wir verwenden einen öffentlichen Lesezugriff, damit du die Anfrageverarbeitung ohne vorherige Authentifizierung lernen kannst. Das Ergebnis kann sich zwischen Anfragen ändern; es ist eine aktuelle Beobachtung und keine fest einzutragende Zahl.
Ausgearbeitetes Beispiel
Für den Eigentümer octocat und das Repository Hello-World lautet der Anfragepfad /repos/octocat/Hello-World auf api.github.com. Die Seite zeigt die zurückgegebenen Werte full_name und stargazers_count.
GitHub: ein Repository abrufen
Zusätzliche technische Übung
Was unterscheidet das Kopieren einer Sterneanzahl ins HTML vom Abrufen beim Drücken der Schaltfläche?
Ausgearbeitete Lösung anzeigen
Kopiertes HTML behält den alten Wert bis zur Bearbeitung. Ein fetch fordert die aktuelle Antwort zu diesem Zeitpunkt an, braucht aber Lade- und Fehlerbehandlung, weil Dienst oder Netzwerk möglicherweise nicht antworten.
- Erklärt, wann der Wert ermittelt wird.
- Erkennt, dass die externe Anfrage fehlschlagen kann.

Schritt 1 · So zeigst du Daten einer externen API auf deiner Website
Prüfe eine erfolgreiche Antwort
Nutze eine Beobachtung, die du mit der Quelle vergleichen kannst.
Erklärung, ausgearbeitetes Beispiel und Übung
Die Idee verstehen
Bitte deinen Assistenten, die passende öffentliche API-Antwort für dein Testrepository zu zeigen, und überprüfe, ob die Seite die vorgesehenen Werte anzeigt. Halte den Test öffentlich und frei von sensiblen Daten.
Eine Anfrage mit Fehlerantwort darf nicht als normales Ergebnis gelten. Du musst den Anfrage- und Fehlercode nicht schreiben, um das sichtbare Ergebnis zu beurteilen.
Ein konkretes Beispiel
Veranschaulichende Antwortwerte: full_name = practice/example und stargazers_count = 12 sollten als sichtbarer Repositoryname practice/example und 12 Sterne erscheinen. Diese erfundenen Werte erklären die Zuordnung; sie sind nicht der aktuelle Zähler des mitgelieferten GitHub-Beispiels.
Dateien für diesen Schritt
Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.
Selbst ausprobieren
Stimmte das Seitenergebnis mit der geprüften Repositoryantwort überein?
Ausgearbeitete Lösung anzeigen
Veranschaulichende Zuordnung mit erfundenen Antwortwerten: Eine Antwort mit full_name = practice/example und stargazers_count = 12 sollte practice/example und 12 Sterne anzeigen. Sie darf weder den vorigen Repositorynamen behalten noch eine fehlende Anzahl zu null machen.
Verwende für deine Live-Prüfung die tatsächliche Antwort des zu diesem Zeitpunkt abgefragten Repositorys. Eine Ratenlimitantwort enthält kein normales Sternergebnis zum Anzeigen.
Was eine gute Antwort enthält
- Gleicht Identität und Sternzahl der Seite mit derselben öffentlichen Dienstantwort ab.
- Gibt eine Fehlerantwort oder ein fehlendes Feld nicht als normalen Nullwert aus.
So funktioniert es (optional)
Erstelle und prüfe eine Anfrage
Kodiere Benutzereingaben und untersuche die Antwort, bevor du sie verwendest.
Lies public/app.js und führe die mitgelieferte Seite über HTTP aus. encodeURIComponent hält jeden Eigentümer-/Repository-Wert in seinem eigenen Pfadsegment. Der Host ist festgelegt; Besucher geben keinen beliebigen Endpunkt vor.
fetch wird auch bei HTTP-Fehlern wie 404 erfüllt; darauf zu warten reicht daher nicht. Prüfe response.ok und relevante Statuscodes, parse JSON und überprüfe die Felder, die die Funktion benötigt. textContent stellt externe Zeichenketten als Text dar.
Der kurze Ausschnitt unten veranschaulicht die allgemeine HTTP-Prüfung. Die vollständige app.js behandelt zuerst gezielt 404 sowie eingeschränkte oder wegen Ratenbegrenzung abgewiesene Antworten, prüft dann andere erfolglose Statuscodes, parst JSON und validiert Felder. Behalte diese Reihenfolge bei, wenn du ein weiteres angezeigtes Feld ergänzt.
Ausgearbeitetes Beispiel
Eine Beschreibung mit spitzen Klammern sollte sichtbarer Text bleiben und kein Seiten-Markup werden. Ein 404 sollte eine Meldung über fehlende Daten oder fehlenden öffentlichen Zugriff anzeigen, statt einer leeren Erfolgskarte.
if (!response.ok) throw Error('Request failed');
const data = await response.json();
result.textContent = data.full_name;Zusätzliche technische Übung
Warum erkennt try/catch allein nicht jede erfolglose HTTP-Antwort?
Ausgearbeitete Lösung anzeigen
HTTP-Fehler können trotzdem ein normales Response-Objekt liefern. Prüfe status/ok und löse einen Fehler aus oder behandle ihn, bevor du den Antwortinhalt als angefordertes Repository verwendest.
- Weiß, dass fetch bei 404/500 erfüllt werden kann.
- Prüft den Status vor der Erfolgsdarstellung.

Schritt 2 · So zeigst du Daten einer externen API auf deiner Website
Probiere fehlende und nicht verfügbare Zustände aus
Halte unterschiedliche Fehler verständlich.
Erklärung, ausgearbeitetes Beispiel und Übung
Die Idee verstehen
Probiere einen nicht existierenden Repositorynamen aus. Teste mit deinem Assistenten auch eine blockierte oder fehlgeschlagene Anfrage auf der lokalen Übungsseite. Erhalte die eingegebene Suche zum Korrigieren oder Wiederholen.
Die Seite soll ein fehlendes Repository von einem vorübergehenden Dienstfehler unterscheiden. Füge keinen privaten Browsertoken hinzu, um ein Ratenlimit zu umgehen.
Ein konkretes Beispiel
„Repository nicht gefunden“ und „Dienst nicht verfügbar; erneut versuchen“ zeigen Besuchern unterschiedliche nächste Schritte.
Dateien für diesen Schritt
Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.
Selbst ausprobieren
Was zeigten die beiden Fehlerfälle, und konnten Besucher fortfahren?
Ausgearbeitete Lösung anzeigen
Veranschaulichendes Fehlerprotokoll: „Ein erfundener Repositoryname zeigte Repository not found or not publicly accessible. Als die Anfrage für einen lokalen Fehlertest absichtlich blockiert wurde, zeigte die Abfrage einen Fehler; Eigentümer- und Repositoryfelder blieben verfügbar und die Schaltfläche ließ einen neuen Versuch zu.“
Die blockierte Anfrage ist eine Simulation, kein Beleg für einen echten GitHub-Ausfall. Ein Ratenlimit sollte zu einem späteren neuen Versuch führen, nicht zu einem privaten Kontotoken im öffentlichen Seitencode.
Was eine gute Antwort enthält
- Dokumentiert unterschiedliche Ergebnisse für ein fehlendes Repository und einen unterstützten Test fehlgeschlagener Anfragen.
- Prüft, dass die Abfrage korrigiert oder wiederholt werden kann, ohne ein privates Token im Browser hinzuzufügen.
So funktioniert es (optional)
Mache Fehlerzustände unterscheidbar
Kein Repository, kein Netzwerk und kein Restkontingent sind unterschiedliche Probleme.
Teste ein echtes öffentliches Repository, einen eindeutig nicht vorhandenen Namen und den Offline-Modus des Browsers. Die Oberfläche entfernt vor jeder neuen Anfrage das alte Ergebnis, verhindert doppelte Übermittlung und aktiviert die Schaltfläche danach wieder.
GitHub kann nicht authentifizierte Anfragen wegen IP-basierter Begrenzungen ablehnen. Reagiere darauf nicht mit einem privaten Token im Browser. Verlege für dauerhafte authentifizierte Nutzung die Verwendung von Zugangsdaten in eine kontrollierte Serverroute und setze gegebenenfalls Caching ein.
Ausgearbeitetes Beispiel
Bleibt unter „Not found“ eine Erfolgskarte sichtbar, können Besucher veraltete Daten für das Ergebnis der neuen Abfrage halten. Das Entfernen des alten Ergebnisses macht den Zustand der aktuellen Anfrage eindeutig.
GitHub: Ratenbegrenzungen der REST-API
Zusätzliche technische Übung
Eine Abfrage schlägt nach vielen Tests fehl. Sollte die Oberfläche melden, dass das Repository null Sterne hat?
Ausgearbeitete Lösung anzeigen
Nein. Null ist ein echter Datenwert. Melde nicht verfügbare oder eingeschränkte Daten und untersuche den Status; die Anzahl bleibt unbekannt, bis eine erfolgreiche Antwort sie liefert.
- Macht aus nicht verfügbaren Daten keine Null.
- Prüft Anfragestatus und Hinweise auf das Kontingent.

Schritt 3 · So zeigst du Daten einer externen API auf deiner Website
Ergänze ein nützliches Ergebnis
Beschreibe die neue Information und lass sie vom Assistenten anbinden.
Erklärung, ausgearbeitetes Beispiel und Übung
Die Idee verstehen
Bitte den Assistenten, neben dem bisherigen Ergebnis das Antwortfeld open_issues_count zu ergänzen und als offene Issues und Pull Requests zu beschriften. Diese GitHub-Gesamtzahl enthält beide Kategorien und darf nicht nur als Fehler bezeichnet werden. Öffne die mitgelieferte Referenz erst nach deinem eigenen Versuch.
Vergleiche den angezeigten Wert mit der tatsächlichen Antwort und wiederhole anschließend erfolgreiche, fehlende und unverfügbare Fälle. Du beurteilst Bedeutung und beobachtete Zustände; der Assistent übernimmt die Browserimplementierung.
Ein konkretes Beispiel
Ein erfundener open_issues_count von 5 könnte zwei offene Issues und drei offene Pull Requests darstellen. Die Beschriftung 5 Fehler würde etwas behaupten, das dieses Feld nicht belegt.
Dateien für diesen Schritt
Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.
Selbst ausprobieren
Ergänze die Gesamtzahl offener Issues und Pull Requests. Wie entsprach die Anzeige der Antwort, und was passierte bei fehlenden oder unverfügbaren Ergebnissen?
Dein Ergebnis: Die aktualisierte Suchseite und beobachtete Ergebnisse für Normalfall, fehlendes Repository und Dienstfehler.
Ausgearbeitete Lösung anzeigen
Veranschaulichende Zuordnung: „Bei einer erfundenen Antwort mit open_issues_count = 5 zeigt die Seite 5 offene Issues und Pull Requests. Die Summe könnte zwei Issues und drei Pull Requests enthalten; sie zählt nicht fünf Programmfehler.“
Veranschaulichendes Testprotokoll: „Die normale Abfrage entsprach der Antwort; das fehlende Repository behielt seine Nicht-gefunden-Meldung; eine simuliert blockierte Anfrage behielt einen erneut versuchbaren Fehler.“ Deine Abgabe sollte deinen tatsächlich abgeglichenen Live-Wert enthalten und ungetestete Prüfungen benennen.
Was eine gute Antwort enthält
- Zeigt open_issues_count als offene Issues und Pull Requests an, nicht nur als Fehler oder Issues.
- Vergleicht den neuen Wert mit einer Antwort und wiederholt normale, fehlende und unverfügbare Zustände.
So funktioniert es (optional)
Deine Aufgabe: ergänze ein nützliches Repository-Feld
Ergänze eine Issue-Anzahl und bewahre klare Grenzen zwischen Daten und Fehlern.
Zeige open_issues_count an, nachdem du den Wert als endliche Zahl validiert hast. Beachte, dass GitHubs Repository-Anzahl laut Dokumentation Pull Requests einschließt; bezeichne sie nicht als exakte Anzahl reiner Fehlermeldungen.
Protokolliere eine erfolgreiche Abfrage, ein fehlendes Repository und einen Offline-Versuch. Halte fest, was Besucher während der Anfrage und nach jedem Ergebnis sehen.
Ausgearbeitetes Beispiel
Eine Beschriftung wie „Open issues and pull requests“ („Offene Issues und Pull Requests“) erklärt den Messwert genauer als „Bugs“ („Fehler“).
Die vollständige exemplarische Anleitung findest du in reference/assignment-walkthrough.txt. Vergleiche ihre Schritte mit deinem Ergebnis und fülle das Testprotokoll mit Beobachtungen aus deinem eigenen Projekt aus.
Zusätzliche technische Übung
Erweitere das Ergebnis um die dokumentierte Anzahl offener Einträge und zeige alle drei Zustände.
Ausgearbeitete Lösung anzeigen
Ergänze open_issues_count zu den Feldern, die nach erfolgreicher Statusbehandlung validiert werden. Verlange eine endliche Zahl und beschrifte sie mit „Open issues and pull requests“, da dieses GitHub-Repository-Feld beides enthält. Das vollständige Referenzskript behält die Darstellung über textContent sowie die bestehenden Lade- und Fehlerzustände bei.
Beispiel-Testdaten: full_name='sample/site', stargazers_count=3, open_issues_count=2 erzeugt „sample/site — 3 stars — 2 open issues and pull requests“, also 3 Sterne und 2 offene Issues und Pull Requests. Das behauptet nicht, dass beide Einträge Fehler sind.
Teste erneut ein erfolgreiches öffentliches Repository, einen 404 und den Offline-Modus. Entferne die vorherige Karte zu Beginn der nächsten Abfrage; ein Fehler darf keine veralteten Anzahlen stehenlassen und nicht verfügbare Daten nicht durch Null ersetzen.
- Validiert die ergänzte Zahl und beschriftet sie zutreffend.
- Nach einer fehlgeschlagenen neuen Abfrage bleibt kein veraltetes Erfolgsergebnis stehen.
War diese Lektion hilfreich?
Hinterlasse ein Like oder teile sie mit jemandem, dem sie helfen könnte.