====== Les API ======
-> [[prog:theorie:api:whatisitapi]]

Quand une application, quelque soit sa programmation, doit communiquer avec le web, elle "devrait" passer par une API.
===== Utile à savoir =====
==== Spécification Open API ====
  * [[https://www.developpez.com/actu/178434/Comprendre-la-specification-OpenAPI-Swagger-et-apprendre-a-utiliser-Swagger-Editor-par-Hinault-Romaric/|Comprendre la spécification OpenAPI (Swagger) et apprendre à utiliser Swagger Editor]]

==== Swagger ====

Il existe un outils Swagger qui permet de générer la documentation des API que l'on créé.

[[prog:theorie:api:swagger|Voir comment installer et utiliser Swagger]]

Cela peut fonctionner dans PHP avec la librairie ''swagger-php'' qui va permettre a travers des **annotations** PHP de générer la documentation.

[[https://www.youtube.com/watch?t=1125&v=no0y4ISItiw|Vidéo pour Installer Swagger-UI]]

Voir la [[https://www.grafikart.fr/tutoriels/swagger-openapi-php-1160|vidéo de GrafikArt sur Swagger et OpenAPI]] pour plus di'nformations
==== API Platform ====
Un bundle pour créer des API sous Symfony : [[https://api-platform.com/]]
  * [[https://www.youtube.com/watch?v=3K7q08LJKso|Vidéo Youtube : Symfony - Créer une API en 5 minutes avec API Platform]]



===== Liens =====
==== Sur ce site ====
  * [[prog:symfony:applications:creer_api:creer_api]]
==== Sur Internet ====

  * **La référence REST**: [[https://restfulapi.net/]]
  *[[http://spec.openapis.org/oas/v3.0.2|Spécification OpenAPI v3.0.2 chez OpenAPI]]
  *[[https://swagger.io/specification/|Spécification d'OpenAPI (Chez Swagger)]]
  *[[https://api-platform.com/|API Platform]]
  * [[https://www.developpez.com/actu/178434/Comprendre-la-specification-OpenAPI-Swagger-et-apprendre-a-utiliser-Swagger-Editor-par-Hinault-Romaric/]]
==== Vidéos ====

  * [[https://www.youtube.com/watch?v=bqpXOT5mwW4|Tuto REST (Grafikart)]]
  * [[https://www.youtube.com/watch?v=vq7yJDuf42E|Apprendre le PHP : Chapitre 28, Utiliser une API avec cURL (Grafikart)]]
  * [[https://www.youtube.com/watch?v=no0y4ISItiw|Documenter son API PHP avec OpenAPI  et Swagger (Grafikart)]]
  * [[https://youtu.be/bqpXOT5mwW4]] 
  * [[https://youtu.be/0FQ6w4CO5Nw]] 
  * [[https://youtu.be/D_XFUE1GeWk]]