Skip to main content

Pourquoi utiliser JSON pour le mobile ?

Les applications mobiles affichent le contenu avec des composants d’UI natifs — pas d’injection HTML, pas d’iframes, pas de webviews nécessaires. L’approche par API JSON est la solution naturelle :

Rendu natif

Recevez des données structurées et effectuez le rendu avec SwiftUI, Jetpack Compose, les widgets Flutter ou les composants React Native.

Léger

Un seul appel HTTP renvoie exactement les champs dont votre application a besoin — aucun SDK à installer, aucune surcharge de runtime JavaScript.

Compatible hors ligne

Mettez en cache les réponses JSON localement pour un affichage hors ligne. Rafraîchissez lorsque la connectivité revient.

Cross-platform

Le même endpoint fonctionne pour iOS, Android, Flutter, React Native, KMP — tout client capable d’effectuer des requêtes HTTP.

Endpoint du Runner

Format de réponse

Le corps de la réponse correspond directement aux données du template résolu — pas d’enveloppe englobante. Les champs statiques sont renvoyés tels quels et les champs de dépendance sont remplacés par des valeurs réelles issues des Datasources :

Codes de statut HTTP

Exemples de code

Swift (iOS)

Kotlin (Android)

Flutter (Dart)

React Native

Gestion de l’identité

Transmettez un identifiant utilisateur stable dans le paramètre de requête rlvt-u : Le même système d’identité alimente tous les Channels Reelevant (web, email, push), la personnalisation est donc cohérente sur tous les points de contact.

Bonnes pratiques

Stockez localement la dernière réponse JSON réussie (par exemple, UserDefaults, SharedPreferences ou une base de données locale). Affichez les données en cache lorsque vous êtes hors ligne et rafraîchissez lorsque la connectivité revient.
Une réponse 204 signifie qu’aucun contenu personnalisé n’est disponible. Affichez une valeur par défaut pertinente ou masquez entièrement la zone de personnalisation.
Lancez l’appel à l’API le plus tôt possible (par exemple, au lancement de l’application ou à l’apparition de l’écran) afin que les données soient prêtes lorsque l’utilisateur fait défiler jusqu’à la zone personnalisée.
Définissez une struct/classe correspondant au schéma de votre JSON Template. Cela détecte les incohérences de schéma à la compilation et rend le refactoring sûr.

Configuration du JSON Template

Les JSON Templates se configurent dans la plateforme Reelevant. Consultez la page Websites > API (JSON) > Intégration technique pour tous les détails sur :
  • La définition du schéma de template
  • Les types de variables (scalaire ou tableau)
  • L’API de gestion des templates
  • La validation au moment de la publication