Content API

Surpasso aide les entreprises à planifier, rédiger et publier des articles SEO et GEO. Connectez ce site existant à Surpasso. Commencez par examiner son framework, ses routes de blog, le stockage des articles, son design et son déploiement, puis réutilisez l’existant. Ne reconstruisez pas le site et ne supprimez ni n’écrasez les articles existants.

Utilisez Content API : le site lit côté serveur les articles publiés dans Surpasso. Les articles restent gérés dans Surpasso et ne sont pas copiés automatiquement dans le CMS local. Environnement serveur : SURPASSO_URL=https://surpasso.ai, SURPASSO_CONTENT_API_KEY=<à configurer en sécurité dans le déploiement>. Envoyez Authorization: Bearer avec la clé serveur. N’utilisez jamais NEXT_PUBLIC_.

Points d’accès réels : GET /api/content/v1/articles?limit=50 renvoie {items:[article],nextCursor} ; suivez nextCursor avec le paramètre cursor. GET /api/content/v1/articles/{id-or-slug} renvoie {item:article}. updated_since filtre les mises à jour. Seuls les articles publiés sont lisibles. Une liste vide n’est pas un échec de connexion ; ne publiez jamais automatiquement un brouillon pour tester. Gérez 401, 404, 429 (respectez Retry-After) et les erreurs temporaires. Prenez en charge ETag / If-None-Match et 304 sans analyser une réponse 304 comme du JSON.

Correspondance des champs : id = identité stable de l’article ; revision = version du contenu ; title = titre ; slug = chemin de l’article ; excerpt = résumé ; contentMarkdown / contentHtml = corps (utiliser le format compatible avec l’éditeur existant et traiter le HTML en sécurité) ; metaTitle / metaDescription = métadonnées SEO ; featuredImage.url / alt = image de couverture et texte alternatif ; images = images du corps ; author, authorType, authorUrl = auteur ; editor, reviewer et leurs champs Type / Url = crédits éditoriaux ; categories / tags = taxonomie ; language = langue du contenu ; contentFamilyId / alternates = relations et liens linguistiques ; structuredData = données structurées ; canonicalUrl = URL canonique. Utilisez les véritables chemins publics du site et ne recopiez pas une URL canonique incorrecte. Gérez proprement les valeurs nulles ; les champs facultatifs non pris en charge ne doivent pas bloquer la publication.

Les articles contiennent aussi publishedAt et updatedAt pour les dates et le rafraîchissement du cache. Réutilisez les routes de blog existantes ; ajoutez index, détail, rendu sécurisé, SEO, URL canonique, Open Graph, liens de langue et Sitemap. Préservez les articles et URL existants. Mettez en cache les lectures réussies et servez le cache lors d’une panne temporaire si possible ; expliquez le délai de rafraîchissement.

Exécutez les vérifications nécessaires, puis expliquez simplement : les fonctions modifiées, les étapes de déploiement, les noms des variables d’environnement à configurer et dans quel tableau de bord, l’URL à saisir dans Surpasso, et comment vérifier un article puis une mise à jour. Demandez-moi de configurer les secrets dans les variables d’environnement de la plateforme de déploiement, jamais dans le chat, Git ou le code du navigateur.