Guide de l'utilisateur : API GraphQL de Dropea avec Apollo

Guide de l'utilisateur : API GraphQL de Dropea avec Apollo

🔑 Générer une clé API dans dropea

1️⃣ Accédez à Mon compte → Jetons d'accès
2️⃣ Donnez un nom à votre clé API ✏️



3️⃣ En option, vous pouvez ajouter une date d'expiration. ⏳ (Si vous n'en définissez pas, la clé API sera permanente.)



4️⃣ Sélectionnez les autorisations (étendues) dont disposera votre clé API, pour cet exemple nous sélectionnerons :
👤 Voir mon utilisateur
🛒 Créer une commande
📦 Lister les produits



* Tout ce que vous voyez dans cette image sont les actions que l'API dropea GraphQL vous permet d'effectuer.

5️⃣ Cliquez sur Créer un jeton d’accès personnel 🔐



Avertissement
🚨 IMPORTANT : Copiez et enregistrez le jeton dans un endroit sûr. ⚠️ Vous ne pourrez plus le revoir.

🚀 Utilisation de la clé API dans Apollo

1️⃣ Entrez 👉 Apollo Studio
2️⃣ Cliquez sur l’icône des paramètres ⚙️



3️⃣ Dans Endpoint, entrez :



4️⃣ Dans En-têtes partagés, ajoutez les éléments suivants :
  1. {
  2. "x-api-key": "VOTRE_CLÉ_API_ICI"
  3. }


5️⃣ Enregistrez les paramètres ✅

  1. Si vous voyez un voyant vert 🟢, tout est correct.
  2. S'il reste rouge 🔴, vérifiez que la clé API est valide et que le point de terminaison est correctement orthographié.

👤 Voir mon utilisateur

1️⃣ Cliquez sur Requête 📜



2️⃣ Sélectionnez l’option Moi 👥.



3️⃣ Cochez les champs que vous souhaitez afficher dans la réponse. 🔎



4️⃣ Appuyez sur le bouton Exécuter ▶️.



5️⃣ Vous recevrez une réponse de 200 ✅ avec les informations utilisateur que vous avez sélectionnées à l'étape 4️⃣.



🛍️ Créer une commande

1️⃣ Cliquez sur Mutation ✏️.



2️⃣ Sélectionnez CommanderCréer 🛒.



3️⃣ Ajoutez les 4 arguments requis 📋.



4️⃣ Complétez chaque argument avec ses données correspondantes.
  1. Au fur et à mesure que vous les ajoutez, ils seront affichés dans la section des variables .


5️⃣ Si vous ne savez pas quelles valeurs utiliser, vérifiez la structure :
  1. Mutation → Création de commande → Client → Pays 🌍
  2. Appuyez sur Ctrl + Espace pour voir une liste des options disponibles.



✨ Et voilà ! Vous pouvez désormais interagir avec l'API Dropea via Apollo Studio, rapidement et facilement. 🚀

Pour toute question, vérifiez les autorisations de votre clé API et les paramètres de vos points de terminaison. Ou contactez-nous ! Toute amélioration est toujours la bienvenue 🔍✅