Il s'agit d'une implémentation de référence Serveur de réservation de l'API v3 pour l'intégration standard basé sur Node.js
Prérequis
Nécessite l'installation de
Premiers pas
Le serveur de réservation est implémenté à l'aide de Node.js standard des bibliothèques ou des frameworks supplémentaires, à titre d'illustration. Si vous utilisez à l'aide de tout autre cadre, vous pourriez facilement remplacer cette implémentation par Express.js, MEAN.js ou tout autre framework de votre choix basé sur Node.js.
L'implémentation n'utilise pas non plus de bibliothèques de tampon de protocole, mais repose sur une sérialisation JSON simple et ses fonctions JSON.parse() et JSON.stringify() méthodes.
Pour télécharger le projet, exécutez la commande suivante:
git clone https://maps-booking.googlesource.com/js-maps-booking-rest-server-v3-skeleton
Le code base se compose uniquement de deux fichiers JavaScript:
- réservationserver.js : serveur HTTP et logique de traitement des requêtes, y compris l'authentification
- apiv3methods.js - Méthodes d'implémentation de l'interface API v3
Une fois les fichiers téléchargés, vous pouvez démarrer le serveur de réservation en exécutant la commande suivante : la commande suivante:
node bookingserver.js
Le squelette écrit toutes les requêtes entrantes et sortantes dans la console. Vous pouvez donc de surveiller son exécution à des fins de traçage.
Si vous avez besoin d'un IDE pour modifier ou déboguer du code, vous pouvez utiliser Visual Studio Code ou toute autre de votre choix. Déboguer le projet en démarrant réservationserver.js dans le fichier l'environnement Node.js et définissez des points d'arrêt si nécessaire.
Tester votre serveur de réservation
Télécharger Utilitaire de test de réservation. Pour l'installer, suivez les instructions d'installation fournies dans sa page README.
Pour les tests, vous devez créer un fichier texte pour stocker vos identifiants. Saisissez votre nom d'utilisateur et votre mot de passe sur une seule ligne, par exemple dans un fichier nommé cred.txt:
nomutilisateur:mot de passe
Vous avez également besoin d'une copie locale d'un flux disponibilité pour vos marchands tests. Dans les exemples de commandes ci-dessous, le flux de disponibilité est avail.json.
Vous pouvez maintenant tester votre serveur de réservation à l'aide des commandes suivantes:
- Tester les appels à la méthode HealthCheck:
bin/bookingClient -server_addr="localhost:8080" -health_check_test=true -credentials_file="./cred.txt"
- Tester les appels à la méthode CheckAvailability:
bin/bookingClient -server_addr="localhost:8080" -check_availability_test=true -availability_feed="./avail.json" -credentials_file="./cred.txt"
- Tester les appels vers les méthodes CreateBooking et UpdateBooking:
bin/bookingClient -server_addr="localhost:8080" -booking_test=true -availability_feed="./avail.json" -credentials_file="./cred.txt"
Lorsque vous mettez en place votre propre serveur de réservation, vous devrez peut-être exécuter des tests supplémentaires sur celui-ci (ex. : list_bookings_test, rescheduling_test, etc.) afin que tous les tests réussissent (-all_tests=true).