Comment démarrer avec notre SDK JavaScript

Chaque fois que nous participons à un Meetup ou que nous intervenons dans une conférence, et que le sujet des systèmes de gestion de contenu est abordé, nous entendons toujours la même chose: « Je n’ai pas envie de m’occuper de tout ça. » Les mots sont parfois un peu plus crus, mais le ressenti reste le même. Lorsque les développeurs JavaScript mettent en place un système de gestion de contenu (CMS), ils en ont assez des contraintes liées à la gestion de systèmes auto-hébergés qui doivent être mis à jour chaque semaine. Cela inclut les soucis liés à l’architecture de la base de données, les problèmes d’évolutivité et d’autres protocoles DevOps. C’est pourquoi nous proposons une nouvelle solution : une plateforme de contenu API-first, indépendante de la technologie. Dans cet article, nous mettrons en évidence les avantages de l’utilisation de Contentful et d’une plateforme de contenu pour votre prochain projet JavaScript.

Avant d’aller plus loin, il est important de clarifier ce que vous obtiendrez avec Contentful. Grâce à notre plateforme de contenu, vous pourrez permettre aux développeurs de récupérer tout type de contenu numérique via des appels d’API, tout en offrant aux éditeurs une application web à l’interface familière pour créer et gérer le contenu. Contrairement à un CMS, nous vous offrons la liberté de créer votre propre modèle de contenu, ce qui vous permet de définir les structures de données dont vous avez besoin. À partir de là, nous mettons à votre disposition des API RESTful vous permettant de diffuser du contenu sur plusieurs canaux — des sites web et applications mobiles jusqu’à l’IoT, les jeux en réalité virtuelle, ou tout autre support que vous pouvez imaginer. Un cas d’utilisation courant pour une plateforme de contenu est celui des applications web qui utilisent des frameworks JavaScript tels que React, Angular et Vue.js. Ou des sites web construits avec un générateur de site statique. Ces liens avec la communauté JavaScript ne sont pas une coïncidence. Notre plateforme de contenu est un excellent choix pour tout développeur JS, car elle permet plus de créativité que les plateformes de contenu traditionnelles. En effet, aucune structure front-end n’est attachée. Il s’agit simplement d’un backend fournissant du contenu via une API RESTful, afin que vous puissiez lui donner l’apparence que vous souhaitez. Et vous pouvez choisir la stack tendance de votre choix — vos données ne sont qu’à un appel Ajax de distance.

Nous fournissons des SDK pour les langages de programmation populaires tels que JavaScript, Ruby, PHP et plus encore. Ces SDK sont conçus pour vous faciliter la vie en tant que développeur lorsque vous utilisez Contentful et vous donnent un accès presque instantané à nos API et à leurs fonctionnalités. Un autre avantage considérable de nos SDK JavaScript est qu’ils sont universels, ce qui signifie qu’ils sont conçus pour fonctionner dans un environnement Node.js et dans les navigateurs. Voyons maintenant à quoi cela ressemble. Pour obtenir le SDK de Content Delivery API (CDA), vous disposez de deux options. Vous pouvez installer le package npm et l’importer dans votre code :

Ou utiliser le fichier JavaScript précompilé et minifié depuis un CDN :

Ensuite, vous pouvez travailler avec l’extrait de code suivant pour récupérer le contenu de Contentful :

En plus d’assurer une véritable séparation entre le contenu et la présentation, un autre aspect attire les développeurs front-end vers Contentful : Images API.Notre API ’Images API’ permet de récupérer et de manipuler des références de fichiers image à partir de ressources média. Une fois que vous avez récupéré une image non modifiée, vous pouvez la redimensionner et la recadrer, modifier sa couleur d’arrière-plan et la convertir en différents formats simplement en ajoutant un paramètre de requête. La diffusion d’images responsives aux dimensions adaptées grâce à notre API vous permet de livrer exactement ce dont vous avez besoin tout en économisant de la bande passante. Pour en savoir plus sur les possibilités offertes, consultez la documentation de référence d’Images API.

Lorsque vous utilisez Contentful, vous êtes en bonne compagnie. Nous sommes nous-mêmes des développeurs, et nous comprenons que même si vous aimez tout ce qui touche au côté serveur, vous ne souhaitez probablement pas perdre du temps à configurer un CMS JavaScript par vous-même. Contentful est conçu pour vous permettre de démarrer en quelques minutes. Vous pouvez créer et déployer un projet qui récupère des données d’un serveur Node.js en seulement cinq minutes. Nous proposons également plusieurs tutoriels sur le backend Node.js pour vous aider à faire vos premiers pas. Pour bien commencer, nous vous fournissons un projet de démonstration basé sur le modèle « Catalogue de produits » de Contentful, afin que vous puissiez le découvrir par vous-même. Une fois Node installé, exécutez simplement les commandes suivantes :

Et voilà, vous devriez maintenant pouvoir afficher cette page en ouvrant https://localhost:3000 dans votre navigateur. Pour commencer à ajouter et à utiliser votre propre contenu, vous pouvez suivre les autres étapes de ce tutoriel sur la création d’une application Express JavaScript avec Contentful.

Nous vous encourageons à consulter la page Contentful pour JavaScript pour des tutoriels, des exemples d’applications, etc. Ou si vous êtes prêt à vous lancer, créez un compte gratuit et commencez à interagir avec notre infrastructure de contenu dès aujourd’hui.