API côté serveur
#
Récupération du code de la synthèseLogora fournit une route d'API pour récupérer la synthèse dans vos pages côté serveur. Cette route d'API renvoie le code HTML complet de la synthèse (CSS et scrips inclus), que vous pouvez insérer dans votre modèle de page. Cette méthode remplace l'insertion du script Logora sur vos pages.
Cette API est utilisée par ailleurs par le code Javascript Logora pour afficher la synthèse.
#
RequêteURL de base :
https://render.logora.fr/synthesis
pour la synthèsehttps://render.logora.fr/widget
pour le widget
Méthode : POST
En-tête : Content-Type: application/json
Paramètres d'URL :
shortname
(requis) : nom de votre application disponible dans votre espace d'administration
uid
(requis) : identifiant unique de la page (le même identifiant que celui inséré côté client)
insertType
(optionnel) : mode d'insertion, ne pas ajouter si insertion standard. Indiquer amp pour une insertion sur une page AMP ou iframe pour une insertion en iframe.
Corps de la requête : Le corps de la requête doit contenir des métadonnées sur la page, en format JSON.
Exemples d'URL de requête :
Le paramètre
source_url
doit avoir un nom de domaine identique à un des domaines autorisés de votre application (modifiable dans Configuration > Général), sinon, la source envoyée ne sera pas prise en compte.
Pour des raisons de performance, les sources publiées avant le 1er janvier 2019 ne sont pas prises en compte.
#
RéponseLa réponse renvoyée est sous cette forme :
Le code HTML renvoyé a pour racine le conteneur suivant :
#
Récupérer la liste des articles (optionnel)Pour éviter de faire des appels inutiles et charger la synthèse uniquement sur les pages article où un débat est lié, vous pouvez utiliser la route prévue par l'API de Logora pour récupérer la liste de vos articles liés à un débat.
#
RequêteURL de base :
https://app.logora.fr/api/v1/updated_sources
Méthode : GET
En-tête : Content-Type: application/json
Paramètres d'URL :
shortname
(requis) : nom de votre application disponible dans votre espace d'administrationtimestamp
(requis) : date depuis laquelle vous souhaitez récupérer les mises à jour des articles (si un débat est associé ou non), en format timestamp Unix (secondes).page
(optionnel) : numéro de pageper_page
(optionnel) : nombre d'éléments par page, par défaut 10
La route renvoie l'ensemble des articles qui ont eu une modification d'association à un débat depuis la date passée en paramètre.
#
RéponseEn-têtes de la réponse :
total
: nombre total d'éléments (sans inclure la pagination)total-pages
: nombre de pages de la réponse