Premiers pas

D’une organisation vide à une réservation confirmée, dans l’ordre qu’attend le produit. Cinq étapes, et l’équivalent API de chacune.

1. Créer une villa

Villas → Ajouter une villa. Un nom et une photo suffisent pour la créer ; tout ce qui compte vient ensuite.

API : POST /api/v1/properties

2. Lui donner des horaires d’ouverture

Villa → Heures d’ouverture. Une grille hebdomadaire : pour chaque jour, l’heure d’ouverture et l’heure de fermeture de la villa. Un jour laissé vide est un jour fermé.

Les réservations sont vérifiées par rapport à cette grille, qui décide donc plus qu’il n’y paraît : une villa ouverte de 09:00 à 18:00 refusera un créneau à 08:30, et le calendrier grise les plages fermées pour que personne n’essaie.

API : PUT /api/v1/properties/{id}/opening-hours

3. Lui donner des tarifs

Villa → Tarifs photoshooting. Un prix par durée. La grille est ce que la villa propose : une durée absente de la grille n’est pas réservable du tout, pas même à un prix négocié. Vous pouvez modifier le montant d’une réservation donnée, mais la durée doit d’abord exister dans la grille.

API : PUT /api/v1/properties/{id}/rates

4. Ajouter un client

Clients → Nouveau client. Seul le nom est obligatoire. Un email vous permet de lui envoyer un lien de paiement, et un lien d’accès à son propre espace.

API : POST /api/v1/customers — ou POST /api/v1/customers/bulk pour importer une liste en un seul appel.

5. Réserver un créneau

Calendrier. Faites glisser sur les heures voulues, le jour voulu : la villa, le créneau et le prix se remplissent tout seuls. Choisissez le client, confirmez.

La réservation est refusée si le créneau tombe en dehors des horaires de la villa, si sa durée est absente de la grille tarifaire, ou si une réservation confirmée le chevauche déjà.

API : POST /api/v1/bookings

Obtenir une clé API

Compte → Clés API → Créer une clé API. Une clé appartient à une seule organisation et porte vos propres droits dans celle-ci. Copiez-la au moment où elle s’affiche — elle ne l’est plus ensuite.

curl -H "x-api-key: $VILLASLOT_API_KEY" \
  "https://villaslot.app/api/v1/me"

Ce premier appel transforme une simple clé en contexte : quelle organisation elle ouvre, quel rôle elle porte, le fuseau horaire et la devise dont dépendent tous les autres appels, et la marge que vous laisse votre offre.