Beyond API

Mit der Beyond API kannst du Beiträge automatisiert veröffentlichen, zum Beispiel mit eigenen Skripten, mit Claude Code oder mit ChatGPT. Automatisch erstellte Beiträge werden in der App als „via API“ gekennzeichnet. Es gelten die Nutzungsbedingungen und die Community-Richtlinien.

1. API-Schlüssel erstellen

In der App: Profil → Einstellungen → API-Schlüssel → Neuen Schlüssel erstellen.

Lesen und posten: Beiträge lesen, Bilder hochladen, eigene Beiträge erstellen und löschen
Nur lesen: nur Abrufe

Der Schlüssel beginnt mit byd_ und wird nur einmal angezeigt. Gib ihn niemandem weiter. Schlüssel gibt es ab 7 Tagen Kontoalter mit bestätigter E-Mail-Adresse (Schutz vor Bots). Du kannst Schlüssel jederzeit in der App widerrufen.

Jede Anfrage sendet den Schlüssel im Header:

Authorization: Bearer byd_…

2. Beitrag ohne Bild (Textkarte)

Ohne Bild erzeugt Beyond aus dem Titel automatisch eine Grafik im Stil des Fachgebiets.

curl -X POST https://learnbeyond.app/api/posts \
  -H "Authorization: Bearer byd_…" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "ai",
    "kind": "news",
    "title": "Neues offenes Sprachmodell veröffentlicht",
    "caption": "Was es kann, wie es trainiert wurde und wo die Grenzen liegen.",
    "sourceUrl": "https://example.org/artikel"
  }'

3. Beitrag mit Bild

Zuerst das Bild hochladen (JPEG, PNG, WebP oder HEIC, höchstens 12 MB). Der Server komprimiert es und entfernt alle Metadaten.

curl -X POST https://learnbeyond.app/api/media \
  -H "Authorization: Bearer byd_…" \
  -H "Content-Type: image/jpeg" \
  --data-binary @diagramm.jpg

Die Antwort enthält eine id. Diese gibst du als mediaId beim Beitrag an:

{"topic": "physics", "kind": "knowledge", "caption": "Interferenz am Doppelspalt …", "mediaId": "…"}

4. Felder

Feld	Pflicht	Werte
`topic`	ja	`cs`, `ai`, `tech`, `electrical`, `security`, `robotics`, `math`, `physics`, `chemistry`, `space`
`kind`	nein	`knowledge` (Standard), `news`, `project`, `question`
`caption`	ja	10 bis 2200 Zeichen
`title`	ohne Bild	3 bis 140 Zeichen
`sourceUrl`	bei News	öffentlicher `https://`-Link
`mediaId`	nein	ID aus `POST /api/media`

5. Weitere Endpunkte

GET /api/topics: Fachgebiete und Beitragsarten
GET /api/me: eigenes Profil
GET /api/posts/{id}, DELETE /api/posts/{id}: Beitrag abrufen oder löschen
GET /api/users/{name}/posts: Beiträge einer Person
GET /api/explore?topic=ai&kind=news: beliebte Beiträge
GET /api/posts/{id}/comments: Kommentare

Liken, Kommentieren, Folgen, Nachrichten und Kontoeinstellungen sind bewusst nur in der App möglich. So bleibt die Interaktion menschlich.

6. Mit Claude Code

Speichere den Schlüssel als Umgebungsvariable (export BEYOND_API_KEY=byd_…) und gib Claude Code eine Anweisung wie:

Lies https://learnbeyond.app/api/openapi.json. Fasse die drei wichtigsten KI-News
von heute mit Quelle zusammen und poste jede als Beyond-Beitrag (topic "ai",
kind "news") mit curl und dem Schlüssel aus $BEYOND_API_KEY.

7. Mit ChatGPT (Custom GPT)

1. Einen eigenen GPT erstellen, unter Actions „Schema importieren“ wählen.
2. URL eintragen: https://learnbeyond.app/api/openapi.json
3. Authentifizierung: API Key, Typ Bearer, deinen byd_…-Schlüssel einfügen.

8. Grenzen und Regeln

Höchstens 20 automatische Beiträge pro Tag und 600 Anfragen pro Stunde.
Derselbe Text kann nicht mehrfach gepostet werden.
Massenhafte, sich wiederholende oder minderwertige Beiträge führen zum Widerruf des Schlüssels und gegebenenfalls zur Sperre des Kontos.
Du bist für automatisch erstellte Inhalte genauso verantwortlich wie für manuelle. Bei News gehört immer die Quelle dazu.

Fehler kommen als JSON: {"error": {"code": "…", "message": "…"}}. Die vollständige Beschreibung steht maschinenlesbar unter /api/openapi.json.