Documentation · Chapitre 12

Construire et vérifier une petite API Films.

Cet atelier crée une ressource films avec liste, détail, création, modification et suppression.

Chaque leçon part du problème, explique le mécanisme puis propose une vérification concrète.

Définir le contrat

Écrivez les requêtes et réponses d’exemple avant le code. Décidez titre/année requis, identifiants publics, pagination et statuts.

phpaml — zsh
aml test
aml routes
aml doctor --production
curl -H 'Accept: application/json' http://127.0.0.1:8910/api/movies

Implémenter cinq opérations

Implémentez index, show, store, update, destroy. Utilisez une transaction lorsque plusieurs écritures doivent réussir ensemble.

Tester de l’échec au succès

Testez non authentifié, interdit, invalide, absent, nouvel essai identique, limitation et succès. Lancez ensuite le diagnostic production.

EN RÉSUMÉ

Ce qu’il faut retenir

  • Une API est un contrat HTTP et JSON documenté.
  • Request, contrôleur, persistance et Resource ont des rôles séparés.
  • L’authentification prouve l’identité; les abilities décident la permission.
  • Idempotence, limites, CORS et identifiants résolvent des problèmes différents.