Les 5 concepts à connaître (expliqués simplement)
1. Endpoint
Définition : L'adresse où vous faites votre demande
https://api.hubspot.com/contacts → L'endpoint pour récupérer les contacts
💡 = L'adresse du restaurant
2. Méthode (GET, POST, PUT, DELETE)
Définition : Ce que vous voulez faire
GET = lire des données | POST = créer | PUT = modifier | DELETE = supprimer
💡 GET = lire le menu | POST = commander | PUT = modifier commande | DELETE = annuler
3. API Key / Token
Définition : Votre badge d'accès pour utiliser l'API
sk_live_51abc123... → Stripe API key
💡 = Votre carte de fidélité qui prouve que vous êtes client
4. Request / Response (Requête / Réponse)
Définition : Ce que vous envoyez, et ce que vous recevez
Requête : 'Donne-moi le client #123' → Réponse : {nom: 'Dupont', email: 'dupont@...''}
💡 = Votre commande → Le serveur vous ramène le plat
5. JSON
Définition : Le format des données échangées (comme un Excel structuré)
{"prenom": "Marie", "age": 32, "ville": "Paris"}
💡 = La recette écrite de manière standardisée
Cas d'usage concrets (avec Make/n8n)
Voici ce que vous pouvez faire avec des APIs, sans coder, en utilisant Make ou n8n :
Cas 1 : Récupérer les nouveaux clients Stripe
Problème :
Vous voulez être notifié sur Slack à chaque nouveau paiement.
Solution (étapes) :
- Utilisez l'API Stripe (endpoint: /charges)
- Méthode: GET (lire les paiements)
- Filtrez: status = 'succeeded' AND created > hier
- Envoyez vers Slack API (endpoint: /chat.postMessage)
Avec Make : Make module 'Stripe - Watch Charges' → 'Slack - Send Message'
Cas 2 : Créer un contact dans HubSpot
Problème :
Quelqu'un remplit un formulaire sur votre site → créer contact dans HubSpot.
Solution (étapes) :
- Formulaire envoie un webhook (une notification) à Make
- Make reçoit les données (email, nom, entreprise)
- Make appelle HubSpot API (endpoint: /contacts)
- Méthode: POST (créer un nouveau contact)
Avec Make : Make module 'Webhook - Custom' → 'HubSpot - Create Contact'
Cas 3 : Enrichir un Google Sheet avec des données API
Problème :
Vous avez une liste d'entreprises dans Sheets, vous voulez ajouter leur nombre d'employés.
Solution (étapes) :
- Pour chaque ligne du Google Sheet
- Appeler API Clearbit (endpoint: /companies/find)
- Paramètre: domain = [nom-entreprise.com]
- Récupérer employees dans la réponse JSON
- Écrire dans la colonne B du Sheet
Avec Make : Make module 'Google Sheets - Watch Rows' → 'HTTP - Make Request' → 'Google Sheets - Update Cell'
Cas 4 : Synchroniser Notion ↔ Airtable
Problème :
Vous gérez vos projets dans Notion, mais l'équipe utilise Airtable.
Solution (étapes) :
- Quand un projet est créé dans Notion
- Récupérer les données via Notion API (endpoint: /databases/query)
- Transformer les champs (mapping)
- Créer l'enregistrement dans Airtable API (endpoint: /bases/{base}/tables/{table})
Avec Make : Make module 'Notion - Watch Database Items' → 'Airtable - Create Record'
Tutoriel : Votre première requête API avec Make
Créons ensemble un scénario qui récupère la météo du jour via une API publique.
Créer un compte Make (gratuit)
Créer un nouveau scénario
Ajouter le module 'HTTP - Make a request'
Configurer la requête
Remplissez les champs :
- • URL :
https://api.open-meteo.com/v1/forecast?latitude=45.9&longitude=6.1¤t_weather=true - • Method : GET
- • Headers : (laisser vide, pas nécessaire)
Cette API retourne la météo actuelle à Annecy (latitude 45.9, longitude 6.1)
Exécuter et voir la réponse
Cliquez sur 'Run once'. Make va :
- 1. Envoyer la requête GET à l'API météo
- 2. Recevoir la réponse JSON (température, vent, etc.)
- 3. Afficher le résultat dans Make
✅ Bravo ! Vous venez de faire votre première requête API sans coder.
Utiliser les données
Ressources pour aller plus loin
APIs publiques pour s'entraîner (gratuites)
Open-Meteo
open-meteo.com
Météo du monde entier
REST Countries
restcountries.com
Infos sur tous les pays
The Cat API
thecatapi.com
Photos de chats aléatoires
JSON Placeholder
jsonplaceholder.typicode.com
Fausses données pour tester
Documentation des APIs populaires
- Stripe API(Paiements)→ stripe.com/docs/api
- HubSpot API(CRM)→ developers.hubspot.com
- Notion API(Workspace)→ developers.notion.com
- Google Sheets API(Spreadsheets)→ developers.google.com/sheets
- Airtable API(Database)→ airtable.com/developers/web/api
Conseil pour apprendre
Commencez par des APIs publiques sans authentification (météo, pays, citations du jour). Une fois à l'aise, passez aux APIs avec API key (HubSpot, Stripe). Enfin, explorez les APIs complexes avec OAuth (Google, Facebook).
Erreurs courantes (et comment les résoudre)
❌ 401 Unauthorized
Cause : Votre API key est manquante, invalide, ou expirée
✅ Solution : Vérifiez que vous avez bien copié la clé. Régénérez-la si nécessaire. Vérifiez qu'elle est dans le bon champ (Header 'Authorization').
❌ 404 Not Found
Cause : L'endpoint (l'adresse) n'existe pas ou est mal écrit
✅ Solution : Vérifiez l'URL dans la documentation. Attention aux typos : /contact vs /contacts fait une différence.
❌ 429 Too Many Requests
Cause : Vous avez dépassé la limite de requêtes autorisées
✅ Solution : Ralentissez vos requêtes (ajoutez un Sleep dans Make). Upgradez votre plan API si nécessaire.
❌ 500 Internal Server Error
Cause : Problème côté serveur de l'API (pas votre faute)
✅ Solution : Attendez quelques minutes et réessayez. Vérifiez le status de l'API (ex: status.stripe.com).
❌ Réponse vide / null
Cause : La requête fonctionne, mais il n'y a pas de données correspondantes
✅ Solution : Vérifiez vos filtres. Ex: vous cherchez des deals créés hier, mais il n'y en a pas eu.
Sécurité : Les règles d'or
Ne JAMAIS partager vos API keys
Une API key = les clés de votre maison. Ne la commitez pas sur GitHub, ne l'envoyez pas par email non chiffré.
Utilisez des variables d'environnement
Dans Make/n8n, stockez vos API keys dans les 'Credentials', pas en dur dans les scénarios.
Régénérez vos clés régulièrement
Tous les 3-6 mois, régénérez vos API keys. Si une clé fuite, révoquez-la immédiatement.
Privilégiez les scopes restreints
Si l'API le permet, créez des keys avec permissions minimales (read-only si vous ne faites que lire).
Utilisez HTTPS, toujours
Vérifiez que l'URL de l'API commence par https:// (pas http://). C'est crypté.
Conclusion
Les APIs vous donnent des super-pouvoirs : connecter n'importe quelle application à n'importe quelle autre, récupérer des données en temps réel, automatiser ce qui était impossible.
Avec Make ou n8n, vous n'avez pas besoin de savoir coder. L'interface visuelle fait le travail pour vous. Il suffit de comprendre les concepts de base : endpoint, méthode, API key, JSON.
Notre conseil : Pratiquez avec des APIs publiques gratuites. Faites des erreurs, lisez les messages d'erreur, consultez la documentation. En 1 semaine de pratique, vous serez à l'aise.