← Documentation/ api / otters

Otters API

Une base pédagogique sur les 8 espèces de loutres : habitat, statut de conservation, particularités, image. Trois endpoints au choix.

Authentification

Appel anonyme (autorisé en mode pédagogique)

Lister les espèces

#

Récupère les 8 espèces de loutres.

GET/api/otters

Retourne la liste complète sans pagination (le dataset est court).

Tester dans le playground
curl -X GET 'https://otter-api-playground.lovable.app/api/otters'
Liste complète.
{
  "count": 8,
  "data": [
    {
      "id": 1,
      "espece": "Loutre d'Europe",
      "nom_scientifique": "Lutra lutra",
      "statut_conservation": "Quasi menacé",
      "image_url": "https://source.unsplash.com/featured/800x600/?european%20otter"
    }
  ]
}

Récupérer une espèce

#

Détail d'une espèce par ID (1–8).

GET/api/otters/:id

Renvoie toutes les infos d'une espèce, image incluse.

Paramètres de chemin
idnumberrequis

ID de l'espèce (1 à 8).

Tester dans le playground
curl -X GET 'https://otter-api-playground.lovable.app/api/otters/2'
Espèce trouvée.
{
  "id": 2,
  "espece": "Loutre de mer",
  "nom_scientifique": "Enhydra lutris",
  "statut_conservation": "En danger",
  "particularites": [
    "Utilise des outils (pierres)",
    "Dort en flottant sur le dos"
  ]
}

Espèce aléatoire

#

Tire une espèce au hasard.

GET/api/otters/random

Pratique pour un quiz ou un widget « espèce du jour ».

Tester dans le playground
curl -X GET 'https://otter-api-playground.lovable.app/api/otters/random'
Espèce aléatoire.
{
  "id": 4,
  "espece": "Loutre cendrée",
  "nom_scientifique": "Aonyx cinereus"
}

Guides

À propos des images

Les URLs d'images pointent vers Unsplash Source — gratuites, hotlinkables, mais peuvent changer entre deux requêtes (sélection algorithmique).