AbiratoBook

Cette API est une partie d'un projet qui deviendra ensuite le site de référence dans la gestion et la vente de livres anciens. Enfin, à mon échelle hein.

Particularités

Dans les fonctions d'IsbnCode, la fonction "search" fait appel à l'api Google Books.

Elle va recherché si l'ISBN rentré par l'utilisateur n'existe pas déjà en base de données. Ensuite, s'il n'exite pas, elle fait appel à l'api Google pour récupérer le nom de l'auteur, la date de parution, l'éditeur et le ou les auteurs. Elle crée ensuite un nouveau livre, enregistre l'ISBN qui lui est lié, lie ou ajoute l'éditeur et le ou les auteurs. Enfin, elle retourne le livre trouvé ou le livre créé en base de données.

Prérequis

Assurez-vous d'avoir installé les éléments suivants avant de commencer :

• PHP >= 7.4
• Composer
• Laravel CLI
• MySQL / MariaDB

php artisan --version

Installation

Clonez ce dépôt dans le répertoire de votre choix :

git clone https://github.com/G8ite/ApiBirato.git

Configurez votre environnement en créant le fichier .env à partir du modèle .env.example.

cp .env.example .env

Créez une base de données dans phpMyAdmin avec le nom "abirato_lrv" et l'encodage "utf8mb3_general_ci".

Initialiser tymon/jwt-auth

php artisan vendor:publish --provider="Tymon\JWTAuth\Providers\LaravelServiceProvider"

php artisan jwt:secret

Vérifiez que JWT_SECRET a été ajouté à votre .env, sinon ajoutez le.

Installez les dépendances du projet avec Composer :

composer install

Exécutez les migrations pour créer les tables de la base de données :

php artisan migrate

Exécutez les seeders pour peupler la base de données avec des données de test :

php artisan db:seed

Générez la documentation de l'API en utilisant L5 Swagger :

php artisan l5-swagger:generate

Utilisation

Démarrez le serveur de développement Laravel :

php artisan serve

Accédez à l'adresse suivante dans votre navigateur :

http://127.0.0.1:8000/api/documentation#/

Vous devriez maintenant voir la documentation de l'API et pouvoir commencer à interagir avec votre application.