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êterlvt-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
Mettre en cache les réponses pour une utilisation hors ligne
Mettre en cache les réponses pour une utilisation hors ligne
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.
Gérer élégamment les réponses vides
Gérer élégamment les réponses vides
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.Appeler tôt, afficher quand c'est prêt
Appeler tôt, afficher quand c'est prêt
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.
Utiliser des modèles typés
Utiliser des modèles typés
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