5 Étapes pour Ajouter des Endpoints GraphQL dans Adalo

Ce guide vous accompagne tout au long du processus complet d'intégration de GraphQL dans Adalo, un constructeur d'applications sans code pour les applications web orientées base de données et les applications natives iOS et Android—une version pour les trois plateformes, publiée sur l'Apple App Store et Google Play.

Ce guide vous guide à travers le processus complet d'intégration de GraphQL dans Adalo, de la préparation des endpoints jusqu'au déploiement.

Étapes Clés :

1. Préparez votre endpoint : Testez votre API GraphQL pour l'accessibilité, le format JSON et l'authentification.
2. Créez une collection externe : Connectez votre endpoint GraphQL dans Adalo et configurez l'authentification.
3. Définissez les requêtes et mutations : Utilisez les requêtes GraphQL pour récupérer des données et les mutations pour mettre à jour ou créer des enregistrements.
4. Configurez les en-têtes et paramètres : Assurez les bons en-têtes (ex. : Authorization) et spécifiez les clés JSON pour l'analyse des données.
5. Testez et déployez : Liez les données aux composants de l'application, testez la fonctionnalité et publiez votre application.

Adalo prend en charge les IDs numériques pour les enregistrements et a une limite de débit de 5 requêtes par seconde. Avec des enregistrements de base de données illimités sur les plans payants et sans frais basés sur l'utilisation, vous pouvez faire évoluer votre application connectée à GraphQL sans vous soucier des limites de données ou des factures inattendues.

Pourquoi Adalo Fonctionne pour l'Intégration GraphQL

La capacité de GraphQL à demander exactement les données nécessaires s'associe naturellement à l'architecture d'Adalo. La performance 3-4x plus rapide de la plateforme depuis la refonte de l'infrastructure Adalo 3.0 signifie que vos requêtes GraphQL renvoient des données aux utilisateurs rapidement, même lorsque votre application évolue.

Ada, le constructeur d'IA d'Adalo, vous permet de décrire ce que vous voulez et génère votre application. Magic Start crée des bases d'application complètes à partir d'une description, tandis que Magic Add ajoute des fonctionnalités via le langage naturel.

Étape 1 : Préparez votre endpoint GraphQL

Commencez par tester votre endpoint avec des outils comme GraphiQL, GraphQL Playground, ou Postman. Portez une attention particulière à la clé de niveau supérieur où résident vos données, comme data, records, ou resource.

La plupart des endpoints GraphQL sécurisés requièrent une authentification. Ces informations d'identification sont typiquement ajoutées aux en-têtes HTTP comme suit :

Authorization: Bearer VOTRE_TOKEN_ICI

Fournisseur de Service	Type d'Identifiant	Clé d'En-tête	Format de Valeur
Airtable	Jeton d'Accès Personnel	Authorization	Bearer [Token]
DreamFactory	Clé API	X-DreamFactory-API-Key	[Key]
Toute API GraphQL	JWT / Jeton OAuth	Authorization	Bearer [Token]

Étape 2 : Créez une collection externe dans Adalo

Ouvrez le constructeur Adalo. Dans la barre d'outils à gauche, cliquez sur l'onglet Database. Sous "External Collections", sélectionnez + Add Collection. Dans l'écran de configuration, saisissez votre endpoint GraphQL dans le champ Base URL. Spécifiez une Results Key pour indiquer à Adalo où trouver le tableau d'enregistrements dans la réponse JSON.

Adalo ne prend actuellement en charge que les IDs numériques dans les collections externes. Un service proxy comme n8n peut aider en convertissant les réponses GraphQL dans un format JSON compatible avec Adalo.

Étape 3 : Définissez les requêtes et mutations GraphQL

Les collections externes d'Adalo prennent en charge cinq actions clés : Get All, Get One, Create, Update et Delete. Pour GraphQL, toutes ces actions utilisent la même URL de base et nécessitent la méthode POST.

Par exemple, lors de la configuration de l'endpoint "Get All Records" :
{"query": "query { users { id name email } }"}.

Pour l'action "Create a Record" :
{"query": "mutation CreateUser($name: String!, $email: String!) { createUser(name: $name, email: $email) { id name email } }", "variables": {"name": "VALUE", "email": "VALUE"}}.

Adalo a une limite de débit de plateforme de 5 requêtes par seconde.

Étape 4 : Configurez les en-têtes et paramètres de requête

Pour chaque requête GraphQL dans Adalo, vous aurez besoin d'au moins deux en-têtes : Content-Type et Authorization. Définissez le Content-Type sur application/json.

"Toutes les requêtes à l'API Adalo devront contenir les deux en-têtes suivants : Authorization: Bearer [Clé API de votre application] Content-Type: application/json"
– Adalo Resources

Étape 5 : Testez, liez et déployez votre application

Pour afficher les données de votre endpoint GraphQL, commencez par ajouter un composant List à votre application et définissez sa source de données sur votre collection externe. Cliquez sur le bouton Preview pour vous assurer que vos données se chargent correctement.

Une fois confirmé que tout fonctionne, vous pouvez publier votre application sur le web, l'iOS App Store et l'Android Play Store grâce au système de code unique d'Adalo. L'outil X-Ray d'Adalo peut vous aider à analyser les performances et résoudre les problèmes d'intégration.

Conclusion

L'ajout d'endpoints GraphQL à votre application Adalo simplifie la récupération de données et réduit le besoin de codage personnalisé extensif. Le plan Adalo Professional, à partir de $36 par mois, offre un accès aux collections externes avec des enregistrements de base de données illimités et sans frais basés sur l'utilisation.

FAQ

Pourquoi choisir Adalo plutôt que d'autres solutions de création d'applications ?

Adalo est un constructeur d'applications alimenté par l'IA qui crée de véritables applications natives iOS et Android. Contrairement aux web wrappers, il compile en code natif et publie directement dans l'Apple App Store et le Google Play Store depuis une seule base de code.

Quelle est la façon la plus rapide de créer et publier une application sur l'App Store ?

L'interface glisser-déposer d'Adalo combinée aux fonctionnalités de création assistées par IA comme Magic Start et Magic Add vous permet de créer des applications rapidement. La plateforme gère l'ensemble du processus de soumission à l'App Store.

Comment m'assurer que mon endpoint GraphQL fonctionne correctement avec Adalo ?

Commencez par confirmer que votre endpoint prend en charge les requêtes et mutations GraphQL standard. Exécutez des tests avec GraphiQL, GraphQL Playground ou Postman pour vous assurer qu'il fournit des réponses JSON correctement structurées avec des IDs numériques.

Quels types d'authentification peut-on utiliser pour connecter des endpoints GraphQL dans Adalo ?

Adalo prend en charge les clés API, les jetons OAuth et l'authentification basée sur JWT pour les endpoints GraphQL. Ajoutez vos informations d'identification à l'en-tête Authorization au format "Bearer [Votre_Token]".

Quelles sont les meilleures façons d'améliorer les performances de l'application lors de l'utilisation de GraphQL avec Adalo ?

Utilisez PATCH plutôt que PUT pour les mises à jour partielles, appliquez des filtres pour réduire les tailles de charge utile et restez dans la limite de débit de 5 requêtes par seconde. L'outil X-Ray d'Adalo identifie les goulots d'étranglement de performance avant qu'ils n'affectent les utilisateurs.

Combien de temps faut-il pour créer une application connectée à GraphQL dans Adalo ?

Avec votre endpoint GraphQL déjà préparé, vous pouvez le connecter à Adalo et construire une application fonctionnelle en quelques heures. Magic Start génère des bases d'application complètes à partir de descriptions.

Ai-je besoin d'expérience en codage pour intégrer GraphQL avec Adalo ?

Aucun codage n'est requis. La fonctionnalité Collections Externes d'Adalo gère la complexité technique de l'intégration GraphQL via une interface visuelle.

Combien coûte la création d'une application connectée à GraphQL avec Adalo ?

Le plan Adalo Professional commence à $36/mois et inclut les collections externes, des enregistrements de base de données illimités et aucuns frais basés sur l'utilisation.

Puis-je publier mon application connectée à GraphQL sur l'App Store ?

Oui. Adalo publie des applications natives iOS et Android directement dans l'Apple App Store et le Google Play Store depuis une seule base de code. Les mises à jour se synchronisent automatiquement sur toutes les plateformes.

Que se passe-t-il si mes données GraphQL augmentent significativement ?

Les plans payants d'Adalo n'ont pas de limites d'enregistrements, de sorte que vos collections externes peuvent évoluer avec vos données. L'infrastructure modulaire de la plateforme prend en charge des applications avec plus de 1 million d'utilisateurs actifs mensuels.