Une API pédagogique,
vraiment réaliste.
Découvre une vraie documentation REST en français — comme Stripe ou OpenAI, mais pensée pour apprendre. Branche les endpoints dans Make, n8n ou Airtable en quelques secondes.
Quatre APIs, treize endpoints
Du CRUD complet sur Users, des citations filtrables, un générateur de datasets, un catalogue de loutres. Tout en CORS ouvert — aucun setup.
Users API
Annuaire de 50 utilisateurs fictifs
Une base déterministe de 50 utilisateurs (toujours les mêmes pour faciliter tes tests). Couvre tout le cycle CRUD : lister, lire un détail, créer, mettre à jour, supprimer. La pagination renvoie `total_pages`, `has_next` et même un objet `links` façon HATEOAS — parfait pour t'entraîner à boucler sur les pages dans Make ou n8n.
Quotes API
Citations françaises catégorisées
Plus de 25 citations françaises curatées dans 5 catégories : nature, sagesse, science, motivation, humour. Trois endpoints au choix selon ton besoin.
Generate API
Génère des datasets fictifs en CSV ou JSON
Génère à la volée jusqu'à 500 lignes de données factices : utilisateurs, produits ou loutres. Sortie CSV (téléchargement) ou JSON.
Otters API
Catalogue des 8 espèces de loutres
Une base pédagogique sur les 8 espèces de loutres : habitat, statut de conservation, particularités, image. Trois endpoints au choix.
Conçu pour Make, n8n & Airtable
Make
Branche un module HTTP, paramètre la méthode, et boucle sur la réponse JSON.
n8n
Crée un nœud HTTP Request, copie l'URL, mappe les champs vers ton workflow.
Airtable
Importe les CSV générés directement, ou utilise l'extension Scripting.
Le module HTTP, expliqué
Le même concept, deux interfaces différentes. Voici, champ par champ, à quoi sert chaque option dans le module HTTP request de Make et le nœud HTTP Request de n8n — pour que tu saches quoi remplir, quand, et pourquoi.
URL
L'adresse complète de l'endpoint, incluant https://. Tu peux la copier telle quelle depuis nos pages de doc, query params déjà inclus.
Authentication / Headers
Pour nos APIs : aucun (anonyme), ou ajoute un header X-API-Key avec demo-key, student-key ou key123. Header = invisible dans l'URL, idéal pour les tokens.
Query parameters
Les paires clé=valeur après le `?`. Servent à filtrer (categorie=motivation), paginer (page=2&per_page=20) ou trier. Une seule règle : URL-encoder les valeurs.
Body
Le contenu envoyé en POST/PUT/PATCH. Choisis Body content type = JSON (application/json), colle le JSON brut. Make et n8n proposent aussi Form-data, Raw, Binary…
Le module HTTP de Make, champ par champ
Module générique pour appeler n'importe quelle API REST. Chaque champ accepte une variable dynamique via le toggle Map.
- Authentication type — Choisis None pour nos endpoints pédagogiques, ou API key si tu veux t'entraîner avec X-API-Key: demo-key.
- URL — L'URL complète, par ex. https://otter-api-playground.lovable.app/api/users — copie-la depuis la page de doc.
- Method — GET, POST, PUT, PATCH, DELETE selon l'action.
- Headers — Paires clé/valeur dans l'en-tête HTTP. Idéal pour Authorization, Content-Type, Accept.
- Query parameters — Paramètres après le ? dans l'URL. Sert à paginer, filtrer, trier. Ex : page=1, per_page=10.
- Body content type — JSON pour 99 % des APIs modernes. Sinon : Raw, Form-data, x-www-form-urlencoded, Binary.
- Parse response — Active-le (Yes) pour que Make décode le JSON et te propose les champs dans le mapper.
- Pagination type — Configure une pagination automatique : Make rappellera l'endpoint page par page sans que tu écrives de boucle.
Astuce : le module Make n'a pas d'import cURL — utilise le bloc « Sans cURL — Make & n8n » présent sur chaque endpoint de la doc pour copier l'URL, les headers, le body un par un.
Le node HTTP Request de n8n, paramètre par paramètre
Plus granulaire que Make : tu actives explicitement chaque section (Send Query Parameters, Send Headers, Send Body) avant d'ajouter les champs.
- Method — GET, POST, PUT, PATCH, DELETE. Le formulaire en dessous s'adapte.
- URL — L'endpoint complet. n8n supporte Import cURL en haut à droite si tu as une commande cURL prête.
- Authentication — None pour nos APIs ; sinon Generic Credential Type → Header Auth pour stocker un X-API-Key réutilisable.
- Send Query Parameters — Toggle à activer pour exposer la table Name/Value. Évite de coller les paramètres directement dans l'URL : c'est plus lisible et mappable.
- Send Headers — Idem pour les en-têtes. Ajoute Authorization, Content-Type, Accept… une ligne par header.
- Send Body — Active-le pour POST/PUT/PATCH. Choisis Body Content Type = JSON, puis Specify Body = Using JSON et colle ton payload.
- Options — Section avancée : Timeout, Follow Redirects, Response Format, Ignore SSL Issues, Pagination automatique, Retry on Fail.
Query vs Headers : les query params sont visibles dans l'URL (filtres, pagination, tri). Les headers restent invisibles côté logs — c'est là qu'on met les clés d'API, tokens, et le Content-Type.
Et Airtable ?
Utilise /api/generate?format=csv pour télécharger un CSV prêt à importer, ou branche l'extension Scripting avec fetch() pour récupérer du JSON dans une vue.
Premiers pas en 30 secondes
- 01
Choisis un endpoint
Par exemple, lister les utilisateurs.
GET /api/users?per_page=5 - 02
Lance la requête
Depuis ton terminal, Postman, ou directement dans Make.
curl https://otter-api-playground.lovable.app/api/users?per_page=5 - 03
Récupère les données
Réponse JSON paginée, prête à mapper dans ton workflow.
{ "page": 1, "per_page": 5, "total": 10, "data": [...] }