/ documentation

La doc OTTERWISE

Toutes les APIs partagent la même logique : URL claire, méthodes REST standards, réponses JSON. Voici ce que tu dois savoir avant de te lancer.

Les APIs

Users API

Annuaire de 50 utilisateurs fictifs

GETPOSTPUTDELETE5 endpoints

Quotes API

Citations françaises catégorisées

GET3 endpoints

Generate API

Génère des datasets fictifs en CSV ou JSON

GET2 endpoints

Otters API

Catalogue des 8 espèces de loutres

GET3 endpoints

Authentification

Pour rester pédagogique, l'authentification est optionnelle. Tu peux appeler les endpoints sans aucune clé. Si tu veux t'entraîner avec une vraie logique d'auth, passe une clé démo dans le header X-API-Key ou en query ?auth=.

demo-keystudent-keykey123

Une clé invalide retourne 401 Unauthorized. Une clé absente est acceptée — utile pour comparer les deux comportements.

curl https://otter-api-playground.lovable.app/api/users \
  -H "X-API-Key: demo-key"

Codes de réponse

Code	Sens	Quand ?
200	OK	Requête réussie, données dans le body.
201	Created	Ressource créée (POST).
204	No Content	Suppression réussie, pas de body.
400	Bad Request	Paramètre ou body invalide.
401	Unauthorized	Clé API fournie mais invalide.
404	Not Found	Ressource introuvable.

Pagination

Les endpoints qui retournent une liste acceptent page (défaut 1) et per_page. La réponse a toujours cette forme :

{
  "page": 1,
  "per_page": 10,
  "total": 50,
  "total_pages": 5,
  "has_next": true,
  "next_page": 2,
  "links": { "next": "...", "prev": null, "first": "...", "last": "..." },
  "data": [ /* tableau de ressources */ ]
}

Astuce : utilise total_pages comme borne supérieure de ta boucle Make / n8n, et stoppe dès que has_next === false.

Pour aller plus loin

Quand tu maîtriseras OTTERWISE, voici d'excellentes APIs publiques (gratuites, sans clé pour la plupart) pour continuer à t'entraîner sur de vraies données.

JSONPlaceholder

Le grand classique pédagogique : posts, commentaires, utilisateurs en CRUD complet.

REST · CRUD

OpenWeatherMap

Météo en temps réel. Inscription gratuite + clé API : parfait pour s'entraîner à l'auth header.

Auth · Géo

PokéAPI

Toutes les données Pokémon. Pagination, ressources liées, idéal pour pratiquer les requêtes en chaîne.

Pagination

REST Countries

Tous les pays du monde, leurs capitales, devises, drapeaux. Aucune clé requise.

No-auth

TheCocktailDB

Recettes de cocktails avec recherche, filtres, images. Endpoints variés.

Open-Meteo

Météo et prévisions sans clé API. Excellent pour Make / n8n sans setup.

No-auth

Frankfurter (taux de change)

Taux de change historiques et actuels. Réponses JSON propres, parfait pour Airtable.

Finance

NASA APIs

Photo astronomique du jour, images Mars, données spatiales. Clé démo `DEMO_KEY` gratuite.

Auth démo

Astuce : pour toutes ces APIs, la même méthode marche dans Make et n8n — un nœud HTTP Request avec la bonne URL et les bons paramètres. C'est exactement ce que tu apprends ici.