REST API

Une API REST (Representational State Transfer Application Programming Interface) est un ensemble de points de terminaison de service web qui utilisent les méthodes HTTP standard — GET, POST, PUT, PATCH et DELETE — pour créer, lire, mettre à jour et supprimer des ressources. Chaque ressource est identifiée par une URL, et le serveur répond avec des données structurées, généralement au format JSON. Les API REST suivent un modèle requête-réponse sans état, ce qui signifie que chaque appel contient toutes les informations dont le serveur a besoin pour le traiter, sans dépendre des requêtes précédentes. Elles constituent l'approche la plus largement adoptée pour que les applications logicielles échangent des données par programmation sur le web.

Pour les éditeurs numériques, une API REST transforme une plateforme de flipbooks d'un tableau de bord autonome en une brique programmable qui s'intègre dans des flux de travail plus larges. Elle permet l'automatisation — importer des PDF, créer des flipbooks, récupérer des données de [statistiques](/glossary/analytics-dashboard) — sans intervention manuelle. Les équipes qui publient des centaines de documents gagnent un temps considérable en scriptant les tâches répétitives. Une API REST ouvre aussi la porte aux intégrations avec les CRM, les plateformes marketing et les systèmes de gestion de contenu, faisant de la plateforme de publication un maillon d'une chaîne d'outils connectée plutôt qu'un produit isolé.

FlipLink fournit un [accès API](/features/api-access) qui permet aux développeurs de créer, mettre à jour, lister et supprimer des flipbooks et des documents par programmation. Tu peux importer des PDF, configurer les paramètres de la visionneuse, récupérer des données de statistiques et gérer les prospects via des points de terminaison API authentifiés. L'API s'intègre à l'écosystème plus large [Automatisation et intégrations](/features/automation-and-integrations), y compris les [webhooks](/glossary/webhook) qui envoient des événements en temps réel à tes propres systèmes. L'authentification utilise des clés API liées à ton compte, et toutes les requêtes et réponses utilisent le format JSON. Les limites de débit sont documentées pour que tu puisses créer des automatisations fiables qui respectent la capacité de la plateforme.

Les API REST reposent sur un petit ensemble de conventions qui les rendent prévisibles : - **Ressources et URL** — chaque entité (un flipbook, un prospect, un rapport de statistiques) a une URL unique. Par exemple, `/api/v1/flipbooks/abc123` identifie un flipbook précis. - **Les méthodes HTTP correspondent à des actions** — GET lit, POST crée, PUT/PATCH met à jour, DELETE supprime. La méthode indique au serveur ce que tu veux faire ; l'URL lui indique quelle ressource. - **Absence d'état** — le serveur ne se souvient pas des requêtes précédentes. Chaque appel inclut son propre jeton d'authentification et ses propres paramètres. Cela simplifie la montée en charge, car n'importe quel serveur d'un cluster peut traiter n'importe quelle requête. - **Codes de statut** — le serveur répond avec des codes HTTP standard : 200 pour le succès, 201 pour la création, 400 pour une requête incorrecte, 401 pour un accès non autorisé, 404 pour une ressource introuvable, 429 pour une limite de débit atteinte. Ces codes permettent à ton automatisation de gérer les erreurs avec élégance. - **Pagination** — les points de terminaison de liste renvoient les résultats par pages, avec des métadonnées indiquant le nombre total et des liens vers la page suivante.

**« API REST et API, c'est la même chose. »** REST n'est qu'un style d'architecture parmi d'autres pour les API. D'autres styles incluent GraphQL, gRPC et SOAP. Quand quelqu'un dit « API » sans précision, il pense généralement à REST, mais les termes ne sont pas interchangeables. **« Les API REST exigent du JSON. »** JSON est le format le plus courant, mais REST en lui-même n'impose aucun format de données précis. Certaines API prennent en charge le XML ou d'autres formats via des en-têtes de négociation de contenu. En pratique, la plupart des API REST modernes — y compris celle de FlipLink — utilisent exclusivement JSON. **« Sans état signifie que le serveur oublie tout. »** L'absence d'état concerne les requêtes individuelles, pas la plateforme dans son ensemble. Le serveur stocke toujours tes flipbooks, tes paramètres et tes données dans sa base de données. Sans état signifie que chaque appel API doit inclure sa propre authentification et son propre contexte au lieu de s'appuyer sur une session côté serveur.

**Quelle est la différence entre une API REST et un [webhook](/glossary/webhook) ?** Une API REST exige que ton application initie les requêtes — tu demandes des données ou envoies des commandes. Un webhook fonctionne dans le sens inverse : le serveur envoie des événements à ton application quand quelque chose se produit (un nouveau prospect capturé, un flipbook consulté). De nombreux flux de travail utilisent les deux : l'API REST pour les opérations à la demande et les webhooks pour les notifications en temps réel. **Qu'est-ce qu'une API RESTful ?** « RESTful » signifie qu'une API suit les principes REST : URL basées sur les ressources, méthodes HTTP standard, communication sans état et réponses structurées. Les termes « API REST » et « API RESTful » sont utilisés de façon interchangeable en pratique. **Faut-il des compétences en programmation pour utiliser une API REST ?** Écrire du code sur mesure offre le plus de souplesse, mais de nombreuses plateformes no-code comme Zapier, Make et n8n peuvent interagir avec les API REST via des interfaces visuelles. L'[accès API](/features/api-access) de FlipLink fonctionne aussi bien avec du code sur mesure qu'avec des plateformes d'automatisation.

Une API REST est l'interface standard pour l'accès programmatique aux services web. Pour les utilisateurs de FlipLink, cela signifie que tout flux de travail qui implique de créer, gérer ou analyser des publications peut être automatisé, intégré et mis à l'échelle au-delà de ce qu'un tableau de bord seul peut offrir.