# Connectez votre univers à Rental Ninja : Présentation de l'API Client
Qu'est-ce que l'API Client ?
L'API Client est une interface de programmation qui vous donne — à vous ou à votre équipe technique — un accès direct à vos données Rental Ninja. Au lieu de vous connecter à la plateforme pour vérifier les disponibilités ou exporter des réservations, vous pouvez connecter n'importe quel système externe à Rental Ninja et automatiser l'échange d'informations en temps réel.
Considérez cela comme une ligne directe entre Rental Ninja et le reste de votre univers technologique.
Elle repose sur des technologies standards du secteur (authentification OAuth 2.0, HTTPS, réponses JSON) et est conçue pour être simple à intégrer — que vous soyez un gestionnaire immobilier travaillant avec un développeur, une société de logiciels créant des solutions basées sur Rental Ninja, ou une grande entreprise gérant une infrastructure technique personnalisée.
Quand votre système fait X, Rental Ninja le sait. Quand Rental Ninja sait Y, votre système réagit.
C'est là toute la puissance d'une API ouverte.
**Que pouvez-vous réellement faire avec ?**
L'API est organisée autour de quatre capacités fondamentales. Voici ce que chacune d'elles permet de réaliser concrètement.
1. Gestion des locations — Vos propriétés, toujours synchronisées
Listez toutes vos propriétés et récupérez tous les détails : nom, devise, gamme de prix, séjour minimum, fenêtre de réservation, frais. Tout ce que vous voyez dans Rental Ninja, vos systèmes peuvent le voir aussi.
Exemple concret : Votre site web personnalisé affiche toujours des informations à jour sur vos propriétés — pas de mises à jour manuelles, pas de descriptions obsolètes. Dès que vous modifiez quelque chose dans Rental Ninja, le changement est répercuté partout.
2. Tarification et disponibilité — Publiez vos propres tarifs
C'est ici que les choses deviennent vraiment intéressantes pour les structures utilisant la tarification dynamique. Vous pouvez lire et écrire des données tarifaires quotidiennes jusqu'à 3 ans à l'avance : tarifs à la nuit, frais pour voyageurs supplémentaires, séjour minimum par jour et restrictions d'arrivée/départ.
Exemple concret : Vous gérez votre propre logique de revenus — peut-être un algorithme personnalisé ou un modèle basé sur une feuille de calcul — et vous souhaitez que ces prix soient intégrés automatiquement dans Rental Ninja. Avec l'API, vous poussez vos tarifs directement, et Rental Ninja les applique. Pas de copier-coller. Pas d'erreur humaine.
La première fois que vous mettez à jour les tarifs via l'API, Rental Ninja règle automatiquement votre modèle de tarification sur 'api' pour cette propriété — une transition nette du manuel vers l'automatique.
3. Accès aux réservations — Toutes vos données de réservation, à votre façon
Récupérez toutes vos réservations grâce à des filtres puissants : par statut, par canal (Airbnb, Booking.com, direct...), par plage de dates, par propriété. Chaque réponse de réservation inclut tout — détails des voyageurs, prix, frais, taxes, commissions et horodatages.
Exemple concret : Votre logiciel de comptabilité récupère automatiquement les réservations confirmées chaque nuit. Votre CRM est notifié lorsqu'une nouvelle réservation arrive. Votre tableau de bord opérationnel affiche le taux d'occupation en temps réel pour toutes vos propriétés. Tout cela sans que personne n'ait à intervenir manuellement.
L'accès est en lecture seule, ce qui signifie que vos données restent en sécurité — aucune modification accidentelle ne peut provenir de systèmes externes.
4. Moteur de réservation — Créez votre propre expérience de réservation
Il s'agit du module le plus puissant. Avec l'API Booking Engine, vous pouvez créer un flux de réservation entièrement personnalisé — votre propre design, votre propre marque, votre propre expérience utilisateur (UX) — tandis que Rental Ninja gère toute la mécanique en arrière-plan.
Le flux fonctionne comme suit :
- Rechercher les propriétés disponibles pour des dates et un nombre de voyageurs donnés
- Obtenir les dates d'arrivée disponibles pour une propriété spécifique
- Obtenir les dates de départ basées sur l'arrivée sélectionnée
- Demander un devis — un détail complet du prix incluant tous les frais et taxes
- Réserver — créer la réservation et rediriger le voyageur vers Stripe pour le paiement
- Confirmer — gérer le résultat de succès ou d'annulation
Exemple concret : Vous avez un site de réservation directe avec votre propre design. Au lieu d'intégrer un widget générique, vous construisez toute l'expérience à votre manière — recherche, résultats, calendrier, résumé des prix, paiement — et l'API s'occupe du travail complexe. Votre marque, votre flux, le moteur de Rental Ninja.
À qui cela s'adresse-t-il ?
L'API Client est particulièrement précieuse pour :
- Les gestionnaires de propriétés possédant des sites web personnalisés qui souhaitent une expérience de réservation entièrement à leur image sans dépendre de widgets tiers.
- Les entreprises utilisant des outils de tarification externes qui ont besoin de pousser les tarifs directement dans Rental Ninja.
- Les équipes opérationnelles gérant leurs propres tableaux de bord et souhaitant des données de réservation et d'occupation en direct.
- Les développeurs de logiciels et intégrateurs créant des produits basés sur Rental Ninja.
- Les grandes entreprises et franchises gérant des portefeuilles importants qui nécessitent une automatisation de système à système.
Si vous vous êtes déjà dit "J'aimerais que Rental Ninja puisse se connecter directement à notre système" — voici la solution.
Bien démarrer
L'accès est simple. Vous recevrez un Client ID et un Client Secret de la part de Rental Ninja, que vous échangerez contre un jeton d'accès (valable un an). À partir de là, chaque requête API est un appel HTTPS standard incluant ce jeton dans l'en-tête.
L'API supporte jusqu'à 300 requêtes par minute, inclut des codes d'erreur clairs pour chaque scénario et renvoie des réponses JSON cohérentes et bien structurées. La documentation complète est disponible sur docs.rental-ninja.com.
Si vous êtes développeur, vous vous sentirez comme chez vous. Si vous êtes un gestionnaire immobilier travaillant avec un développeur ou un partenaire technique, cela leur donne tout ce dont ils ont besoin pour construire une intégration solide.
Une vision globale
Chaque fonctionnalité que nous développons chez Rental Ninja vise le même objectif : vous donner plus de contrôle sur votre activité et vous libérer des tâches qui ne devraient pas requérir votre attention.
Les Triggers vous permettent d'automatiser vos communications. Le Smart Pricing optimise vos tarifs. L'API Client ouvre la porte à la connexion de Rental Ninja avec tous les autres outils de votre écosystème — pour que l'ensemble de votre exploitation fonctionne comme une seule unité, et non comme une collection de pièces déconnectées.
Prêt à connecter vos systèmes à Rental Ninja ?
Contactez notre équipe d'intégration à tech@rental-ninja.com ou réservez une démo pour que nous puissions vous accompagner.