Öffentlichen Status und geschützte Suche getrennt betrachten

Trennen Sie die öffentliche HTTP-Statusantwort vom authentifizierten Zugriff auf ein historisches Reddit-Archiv. Mit Abfragebeispiel und transparenten Kosten.

API-Schlüssel erhalten

Beispielanfrage

cURL

curl --fail-with-body "https://api.redditgateway.com/v1/status"

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditgateway.com/v1/search?q=database&subreddit=backend&limit=3"

Zwei Aufgaben für Ihr Backend

Reddit Gateway bietet einer Backend-Plattform einen unabhängigen Zugang zu einem historischen Reddit-Archiv. Der Dienst ist weder eine offizielle Reddit-API noch ein transparenter Proxy für beliebige Reddit-Aufrufe. Er liefert keine Live-Daten und bietet keine Funktionen zum Veröffentlichen, Abstimmen oder Versenden privater Nachrichten. Für die Integration sind zwei Aufgaben getrennt zu behandeln: die öffentliche HTTP-Statusantwort und der geschützte Abruf archivierter Datensätze.

Der öffentliche GET-Endpunkt https://api.redditgateway.com/v1/status benötigt keinen API-Schlüssel und verbraucht keine Credits. Seine statische Antwort zeigt, dass die HTTP-Anwendung antwortet. Sie prüft weder das Suchsystem noch die Verfügbarkeit bestimmter Archivdaten. Auch Schlüsselgültigkeit, Kontostand und Zahlungsstatus lassen sich daraus nicht ableiten. Ein grüner Status in Ihrer eigenen Oberfläche darf deshalb nicht als Nachweis einer funktionierenden Suche ausgegeben werden.

Geschützte Abrufe benötigen dagegen einen gültigen Schlüssel dieser Domain und ausreichendes Guthaben. Ein erfolgreicher Aufruf belegt nur, dass diese konkrete Anfrage beantwortet wurde. Er belegt keine vollständige Erfassung eines Subreddits, keinen festen Aktualisierungsrhythmus und keine unveränderlichen Ergebnisse bei späterer Wiederholung. Fehlende Datensätze und optionale Felder müssen in Ihrer Verarbeitung möglich bleiben. Planen Sie keine lückenlose Archivabdeckung als zugesicherte Eigenschaft ein.

Eine begrenzte Suche nachvollziehen

Das Beispiel lautet GET https://api.redditgateway.com/v1/search?q=database&subreddit=backend&limit=3. Dabei ist q=database die Textsuche, subreddit=backend beschränkt die Abfrage auf die genannte Community und limit=3 begrenzt die Antwort auf höchstens drei Datensätze. Ohne kind kann die Suche Beiträge und Kommentare enthalten. Drei Treffer oder eine bestimmte Relevanz sind nicht zugesichert. Übertragen Sie serverseitig entweder X-API-Key: <key> oder Authorization: Bearer <key>; beide Formen werden unterstützt.

Dieser synthetische Antwortausschnitt dient ausschließlich der Erklärung: {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. Er stammt nicht aus einer ausgeführten Anfrage; insbesondere ist balance=99 kein beobachteter Kontostand. Die leere Liste veranschaulicht, dass auch ein erfolgreicher Abruf ohne Treffer einen Credit kostet. Ihre Anwendung kann die empfangene Seite zunächst prüfen und speichern, bevor sie weitere kostenpflichtige Abrufe plant.

Die Ergebnisse sind flache Datensätze. Falls parent_id oder link_id vorhanden sind, können Sie empfangene Einträge lokal zuordnen; dadurch entsteht kein garantiert vollständiger Diskussionsbaum. Die interne Reihenfolge _doc ist keine Sortierung nach Zeit, Relevanz oder Bewertung. min_score setzt lediglich eine Bewertungsuntergrenze. limit und page liegen jeweils zwischen 1 und 100. Selbst das Abrufen aller zugänglichen Seiten beweist weder Vollständigkeit noch unveränderte Wiederholbarkeit.

Schlüssel, Guthaben und Zahlungen getrennt verwalten

Ein Konto entsteht mit E-Mail-Adresse und einem Passwort von 12 bis 72 UTF-8-Bytes. Der Schlüssel wird unmittelbar nach erfolgreicher Registrierung einmal angezeigt, bereits vor einer bezahlten Aufladung. Sichern Sie ihn dann außerhalb öffentlich ausgelieferten Codes. Die möglichen 100 Test-Credits unterliegen einer netzwerkweiten Missbrauchskontrolle. Konten, Schlüssel und Guthaben bleiben dennoch domainspezifisch. Anmeldung, Guthaben, Rechnungen und Schlüsselerneuerung finden Sie im Kontobereich der Seite API-Schlüssel erhalten.

Ein erfolgreicher geschützter Abruf kostet einen Credit, auch mit leerer Ergebnisliste. Ein Credit entspricht $0.001; $1 ergibt 1000 Credits. Die kleinste bezahlte Aufladung beträgt $50 und ergibt 50000 Credits. Bezahlte Credits verfallen nicht; ein Abonnement ist nicht erforderlich. Ungültige Anfragen werden nicht belastet, bei einem Fehler des vorgeschalteten Suchdienstes wird die Reservierung erstattet. Ein verlorener Client-Empfang kann dennoch auf einen berechneten Servererfolg folgen; ein erfolgreicher Wiederholungsversuch kostet erneut.

Erstellen Sie vor einer Überweisung eine Rechnung im angemeldeten Kontobereich. Unterstützt werden USDT auf TRON als TRC20 und USDC auf Ethereum Mainnet als ERC20. Verwenden Sie Empfänger und genauen Betrag der aktuellen Rechnung und reichen Sie anschließend den vorhandenen Transaktionshash zur Prüfung ein. Nur eine tatsächlich bestätigte, passende Überweisung kann gutgeschrieben werden. Eine sofortige Bestätigung ist nicht zugesichert. Weder diese Prüfung noch der private Kontostand gehört zur öffentlichen Statusantwort.