Content API

Surpasso unterstützt Unternehmen bei Planung, Erstellung und Veröffentlichung von SEO-/GEO-Artikeln. Verbinden Sie diese bestehende Website mit Surpasso. Prüfen Sie zuerst Framework, Blogrouten, Artikelspeicherung, Design und Bereitstellung und verwenden Sie vorhandene Funktionen weiter. Bauen Sie die Website nicht neu auf und löschen oder überschreiben Sie keine bestehenden Artikel.

Content API verwenden: Die Website liest veröffentlichte Surpasso-Artikel serverseitig. Artikel werden in Surpasso verwaltet und nicht automatisch in das lokale CMS kopiert. Servervariablen: SURPASSO_URL=https://surpasso.ai, SURPASSO_CONTENT_API_KEY=<sicher in den Bereitstellungseinstellungen konfigurieren>. Authorization: Bearer mit dem serverseitigen Schlüssel senden. Niemals NEXT_PUBLIC_ verwenden.

Tatsächliche Endpunkte: GET /api/content/v1/articles?limit=50 liefert {items:[article],nextCursor}; nextCursor als cursor-Parameter für weitere Seiten verwenden. GET /api/content/v1/articles/{id-or-slug} liefert {item:article}. updated_since filtert Aktualisierungen. Nur veröffentlichte Artikel sind lesbar. Eine leere Liste ist kein Verbindungsfehler; niemals automatisch einen Entwurf zum Testen veröffentlichen. 401, 404, 429 (Retry-After beachten) und temporäre Fehler behandeln. ETag / If-None-Match und 304 unterstützen; eine 304-Antwort nicht als JSON parsen.

Feldzuordnung: id = dauerhafte Artikelidentität; revision = Inhaltsversion; title = Überschrift; slug = Artikelpfad; excerpt = Zusammenfassung; contentMarkdown / contentHtml = Textkörper (passendes Format des vorhandenen Editors verwenden, HTML sicher verarbeiten); metaTitle / metaDescription = SEO-Metadaten; featuredImage.url / alt = Titelbild und Alternativtext; images = Bilder im Inhalt; author, authorType, authorUrl = Autor; editor, reviewer und jeweilige Type-/Url-Felder = redaktionelle Angaben; categories / tags = Taxonomie; language = Inhaltssprache; contentFamilyId / alternates = Sprachbeziehungen und Links; structuredData = strukturierte Artikeldaten; canonicalUrl = kanonische URL. Verwenden Sie die tatsächlichen öffentlichen Pfade der Website und übernehmen Sie keine falsche kanonische URL. Nullwerte sauber behandeln; nicht unterstützte optionale Felder dürfen die Veröffentlichung nicht blockieren.

Artikel enthalten außerdem publishedAt und updatedAt für Datumsanzeige und Cache-Aktualisierung. Bestehende Blogpfade wiederverwenden; Übersicht, Detail, sichere Textdarstellung, SEO, Canonical, Open Graph, Sprachlinks und Sitemap ergänzen. Bestehende Artikel und URLs erhalten. Erfolgreiche Abrufe zwischenspeichern und bei vorübergehenden Ausfällen nach Möglichkeit Cache anzeigen; Verzögerung der Aktualisierung erklären.

Führen Sie geeignete Prüfungen aus und erklären Sie anschließend in verständlicher Sprache: geänderte Funktionen, Bereitstellungsschritte, Namen der zu konfigurierenden Umgebungsvariablen und das jeweilige Dashboard, die in Surpasso einzutragende URL sowie die Prüfung eines Artikels und einer Aktualisierung. Geheimnisse sollen ausschließlich über die Umgebungsvariablen der Bereitstellungsplattform konfiguriert werden, niemals im Chat, in Git oder im Browsercode.