Reddit App API
DE

Reddit App API · 06 / 08

Ein Datum soll die Aussage einordnen, nicht die Karte schmücken

Trennen Sie Quellerstellung und App-Abruf, behandeln Sie fehlende Datumsangaben und erklären Sie, warum historische Diskussionen keine aktuellen Wanderratschläge sind.

Die gezeigte Zeit eindeutig benennen

Bei historischen Reddit-Diskussionen in Ihrer App ist besonders wichtig, welcher Zeitstempel das Alter des Ergebnisses bestimmt. Quellerstellung, Abruf eines Datensatzes durch Ihre App und Aufnahme ins Archiv beantworten unterschiedliche Fragen. Beschriften Sie nicht alles mit Aktualisiert. Eine heutige Anfrage kann eine alte Diskussion abrufen, ohne deren Inhalt aktuell zu machen.

Bei der hypothetischen Wanderfunktion muss die Person, die Ratschläge zu Offline-Karten vergleicht, erkennen, dass ein Verweis historisch ist. Ist ein gültiger created_utc-Wert vorhanden, beschriften Sie das angezeigte Datum als Erstellungsdatum des ursprünglichen Beitrags oder Kommentars. Die API reicht flache Quelldatensätze durch; nehmen Sie weder an, dass jeder dieses Feld enthält, noch dass sein Wert für die Anzeige gültig ist.

Fehlende Daten als echten Gestaltungszustand behandeln

Betrachten Sie zwei vorgeschlagene Kartenbeschriftungen, keine abgerufenen Beispiele: Ursprüngliches Datum: aus dem Datensatz verfügbar, und Ursprüngliches Datum: nicht verfügbar. Auch die zweite Karte sollte lesbar bleiben, ohne heimlich das heutige Datum einzusetzen. Ein fehlender Zeitstempel ist ein fehlender Nachweis, kein Nachweis einer neuen Diskussion.

Prüfen Sie Typ und Wertebereich des Feldes vor der Formatierung. Machen Sie bei relativen Angaben wie vor Jahren die Grundlage klar und ergänzen Sie möglichst ein verständliches absolutes Datum. Berücksichtigen Sie die Anzeigezeitzone der App. Ist die Client-Uhr falsch oder lässt sich der Wert nicht sicher deuten, wählen Sie einen vorsichtigen Zustand für fehlende Daten statt eines präzisen, aber unzuverlässigen Alters.

Den Abrufverlauf getrennt halten

Ihre App kann Abruf- oder Speicherzeitpunkte festhalten, um den Zustand einer lokalen Leseliste zu erklären. Beschriften Sie solche Werte mit Von dieser App abgerufen oder Lokal gespeichert. Sie beschreiben eine App-Aktion, nicht Erstellung, letzte Bearbeitung, letzte Antwort, Archivaufnahme oder aktuelle Richtigkeit des Datensatzes. Für sich genommen sind sie auch keine Latenzmessung.

Erfinden Sie aus der Anfragezeit kein Aufnahmedatum des Archivs. Die aktuelle Schnittstelle verspricht diesen Zeitstempel nicht für jeden Datensatz. Ebenso wenig lässt sich aus dem ältesten oder neuesten Eintrag einer kleinen Antwort ein vollständiger Abdeckungszeitraum ableiten. Ein fehlendes Ergebnis kann mehrere Gründe haben und beweist nicht, dass die Diskussion nie existiert hat.

Nach Datum filtern, ohne einen Zeitverlauf zu behaupten

Ein Datumsfilter begrenzt Ihre Suche, liefert aber keine chronologische Sortierung. from und to akzeptieren UTC-Daten im Format YYYY-MM-DD, einschließlich des gesamten to-Tags. Eine hypothetische Anfrage mit from=2025-01-01 und to=2025-12-31 verlangt diesen Quelldatumsbereich, nicht zuerst das neueste Ergebnis.

Der Dienst liefert Archivdaten in _doc-Reihenfolge. Sortiert Ihre App die abgerufenen Datensätze lokal anhand eines gültigen Erstellungsfeldes, beschreiben Sie dies als Sortierung dieser geladenen Datensätze. Sie belegt nicht, dass die erste Karte der neueste Treffer im gesamten Archiv ist. Datensätze ohne brauchbares Datum brauchen eine eigene, erklärte Platzierung statt eines erfundenen Zeitstempels.

Das Datum auf die Entscheidung der lesenden Person beziehen

Eine alte Diskussion kann Wandernden helfen, Fragen zu Offline-Karten auszuwählen: Downloadvorbereitung, Akkuverbrauch oder Gerätegrenzen. Sie belegt weder, dass ein Weg offen ist, noch dass ein Produkt heute gleich funktioniert oder ein früherer Umweg weiterhin geeignet ist. Trennen Sie die Lesefunktion von Navigation und aktuellen Sicherheitsinformationen.

Ein sachlicher Hinweis auf historische Inhalte ist hilfreicher als ein unbelegtes Aktualitätsabzeichen. Vermeiden Sie Kürzlich aktiv, Vollständig synchronisiert oder Live-Ratschläge ohne gesonderte Nachweise für die konkrete Behauptung; diese Archivantwort liefert sie nicht. Erhalten Sie vorhandene Quellenlinks und behandeln Sie geänderte oder verschwundene Quellseiten. Unter /de/#field-notes finden Sie Hinweise zur Gestaltung von Diskussionskarten und lokalen Leselisten.