
Mini-Lektion · Deutsch
So zeigst du Daten einer externen API auf deiner Website
Nutze eine fertige Repository-Suchseite, ergänze mit einem Assistenten ein nützliches Ergebnis und prüfe normale, fehlende und nicht verfügbare Antworten.
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.
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.
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.
Was du lernen wirst
- 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.
Schritt 1
Öffne die fertige Suche
Frage einen Wert beim Dienst ab, statt eine feste Zahl in die Seite zu schreiben.
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.GitHub: ein Repository abrufen
Dateien für diesen Schritt
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (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
Extra implementation exercise
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 2
Prüfe eine erfolgreiche Antwort
Nutze eine Beobachtung, die du mit der Quelle vergleichen kannst.
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
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (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;Extra implementation exercise
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 3
Probiere fehlende und nicht verfügbare Zustände aus
Halte unterschiedliche Fehler verständlich.
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.
GitHub: Ratenbegrenzungen der REST-API
Dateien für diesen Schritt
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (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
Extra implementation exercise
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 4
Ergänze ein nützliches Ergebnis
Beschreibe die neue Information und lass sie vom Assistenten anbinden.
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
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (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.
Extra implementation exercise
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.
Weiterlernen
- So erstellst du deine erste persönliche Website
- So veröffentlichst du deine Website über GitHub
- So verbindest du eine eigene Domain mit deiner Website
- So richtest du E-Mail auf deiner eigenen Domain ein
- So machst du deine Website auf Telefonen benutzbar
- So laden Bilder deiner Website schneller
- So erhältst du Website-Feedback in deinem Postfach
- So ergänzt du deine Website um E-Mail-Abonnements
- So sendest du automatisierte E-Mails von deiner Website
- So speicherst du Formulareingaben in einer Datenbank
- So können sich Menschen auf deiner Website anmelden
- So hältst du eine Seite privat
- So können Nutzer ihre Profilinformationen bearbeiten
- So können Nutzer Bilder hochladen
- So hältst du API-Schlüssel aus deinem Frontend heraus
- So ergänzt du deine Website um einen KI-Chatbot
- So beantwortet ein Chatbot Fragen anhand deiner eigenen Inhalte
- So ergänzt du deine Website um einen Blog
- So ergänzt du deine Website um eine Suche
- So ergänzt du deine Website um eine weitere Sprache
- So hilfst du Google, deine Website zu finden
- So reparierst du die Vorschau deiner Website beim Teilen eines Links
- So misst du Besuche und nützliche Aktionen auf deiner Website
- So können Besucher einen Termin buchen
- So nimmst du eine Zahlung auf deiner Website an
- So prüfst du Website-Änderungen vor dem Veröffentlichen
- So machst du ein fehlerhaftes Website-Deployment rückgängig
- So sicherst du deine Website-Daten und stellst sie wieder her
- So findest und behebst du Fehler auf deiner veröffentlichten Website