Ein Abfragefenster statt eines Abonnements festlegen
Verwenden Sie from und to auf Inhaltsrouten für zeitliche Abfragefenster, statt Ereignisse auf einer dauerhaften Verbindung zu erwarten. Reddit Stream API ist ein unabhängiges historisches Archiv, kein offizieller Live-Dienst, SSE oder WebSocket. Jede Ausführung Ihrer Aufgabe sendet getrennte Anfragen. Regelmäßiges Abfragen garantiert weder Aktualität noch, dass zwischen den Ausführungen alle neuen Daten erschienen sind. Der Zeitplan gehört zu Ihrem Client und ist kein zugesicherter Aktualisierungsrhythmus des Archivs.
Die Datumswerte verwenden YYYY-MM-DD, beziehen sich auf created_utc in UTC und schließen den in to angegebenen Tag vollständig ein. Es sind keine Zeitpunkte der Aufnahme ins Archiv, und Stundenangaben sind nicht vorgesehen. Bei angrenzenden Tagesfenstern sollten Sie Anfangs- und Endtage so wählen, dass die inklusive Grenze keine unbeabsichtigte Überschneidung erzeugt. Diese lokale Organisation garantiert weder vollständige Fenster noch identische Ergebnisse bei späteren Abfragen.
Beginnen Sie mit https://api.redditstreamapi.com/v1/posts?subreddit=datasets&limit=3&page=2, dem Startseitenbeispiel. Es fordert bis zu drei Beiträge aus datasets auf Seite zwei an, keinen chronologischen Fortsetzungspunkt. Wählen Sie X-API-Key: <key> oder Authorization: Bearer <key> und halten Sie das Geheimnis auf Ihrem Server. Die Kontositzung ist von diesen Headern getrennt; die Seite API-Schlüssel erhalten erläutert den Zugang.
Eine Seite vor dem lokalen Fortschritt speichern
Wählen Sie eine Seitengröße von 1 bis 100 entsprechend den Möglichkeiten Ihrer Anwendung. Der Maximalwert verspricht weder optimale Leistung noch eine Mindestzahl an Datensätzen. page reicht ebenfalls von 1 bis 100, und jede Anfrage liefert eine Seite. Prüfen Sie zunächst HTTP-Status und data als Liste, bevor Sie verfügbare Felder umwandeln. Eine erfolgreich empfangene leere Liste ist ein zulässiges Ergebnis.
Speichern Sie Antwort, Parameter und empfangene Seitennummer vor dem Aktualisieren Ihres lokalen Kontrollpunkts. Dieser gehört zur Anwendung und ist kein stabiler Cursor des Archivs. Die erneute Verarbeitung einer lokalen Kopie erfordert keinen weiteren Abruf; dieselbe Seite erneut anzufordern kann neue Kosten verursachen. Die zweite Antwort enthält nicht garantiert dieselben Datensätze, Felder oder dieselbe Reihenfolge. Halten Sie diesen Unterschied im Verarbeitungsbericht fest.
Lesen Sie total zusammen mit relation: eq bezeichnet einen exakten Abfragegesamtwert, gte eine Untergrenze und unknown einen nicht verlässlichen Gesamtwert, möglicherweise null. Ersetzen Sie unbekannt nicht durch null Treffer. Speichern Sie has_more und window_exhausted als Hinweise auf erreichte Grenzen. Bei Seite 100 dokumentieren Sie die Grenze; eine leere Aufgabenliste oder eine exakte Anzahl beweist keinen vollständigen Download.
Grenzen, Fehler und Kosten unterscheiden
Datensätze folgen _doc, einer internen Reihenfolge, nicht Chronologie, Relevanz oder Bewertung. min_score filtert ohne Sortierung. Lokales Sortieren oder Entfernen von Dubletten belegt keine vollständige Extraktion oder lückenlose Ereignisfolge. Vorhandene parent_id oder link_id erlauben lokale Verknüpfungen, ohne vollständigen Gesprächsverlauf zu garantieren. Die Dokumentation beschreibt die tatsächlichen Filter und unterscheidet Inhaltsabfragen, Einzelabrufe mit id und Community-Katalog.
Bei HTTP 400 korrigieren Sie Parameter, bei 401 Schlüssel und Header, bei 402 prüfen Sie Guthaben im Kontobereich und bei 429 begrenzen und verzögern Sie weitere Versuche. Wachsende Pausen mit einer Höchstzahl von Wiederholungen sind möglich, garantieren aber keine spätere Wiederherstellung. /v1/status ist öffentlich und kostenlos, liefert jedoch nur eine statische Erklärung und bestätigt eine HTTP-Antwort. Schlüssel, Guthaben und Suchsystem werden dabei nicht geprüft.
Jeder erfolgreiche Abruf kostet einen Credit, auch leer oder wiederholt. Ungültige Anfragen buchen nichts ab; Fehler des vorgeschalteten Dienstes erstatten die Reservierung. Ein Client-Zeitlimit kann einen berechneten Erfolg verbergen, und eine erfolgreiche Wiederholung kostet erneut. Auch ein späterer lokaler Fehler hebt den entfernten Erfolg nicht auf. Kalkulieren Sie Seiten und Tests anhand der Preise: $1 für 1000 Erfolge, mindestens $50 je bezahlter Aufladung, ohne Abonnements oder Verfall gekaufter Credits.
