REST/HTTPS
Style API unifié pour le cloud et la passerelle locale ; Échange de données JSON
Retour à Support
API développeur
Vue d'ensemble REST API, authentification et documentation modèles d'appareils.
La plateforme de développement Point Pur Intelligent fournit des RESTful API standardisés et des SDK ouverts pour les intégrateurs, les fournisseurs PMS/CRS et les ISV — couvrant l'intégration de device, l'état des salles, le contrôle scene, les données énergétiques et les abonnements aux événements. Via le cloud ou une passerelle locale, intégrez rapidement le contrôle des chambres Point Pur Intelligent dans les opérations de votre hôtel et les systèmes de gestion des bâtiments.
Téléchargez les documents SDK & · Plateforme de gestion cloud · Demander des clés API
Capacités de la plateforme
-
RESTplein API
Requête/réponse JSON sur HTTPS, chemins versionnés — intégration facile pour les systèmes front-end, back-end et tiers.
-
Multilingue SDK
Exemples Java, Python et Node.js ainsi que des utilitaires de signature pour raccourcir les cycles d'intégration et de mise en service.
-
Événements Webhook
Les changements d'état de la salle, les alertes et les résultats cene sont diffusés de manière proactive – avec nouvelle tentative et vérification de la signature.
-
Bac à sable
Locataire de test dédié et appareils simulésce pour l'intégration de pré-production et la validation de charge (s'appliquent à enable).
API modules
Interface regroupés par domaine d'activité avec une autorisation étendue ; les définitions de champs et les limites de débit suivent la documentation officielle.
-
Device points et
Interroger RCU, l'état en ligne du panneau et du capteur ; valeurs de point de lecture/écriture, E/S numériques et analogiques.
-
Statut des chambres &
Synchronisez l'enregistrement/le départ, DND, MUR, SOS et d'autres états de la chambre ; mapper vers PMS numéros de chambre.
-
Liaison Scenes &
Trigger welcome, vacant power-off, meeting mode and other scenes ; query results and failure reasons.
-
Rapports sur l'énergie &
Puissance globale et données HVAC par pièce, étage ou espace public ; exporter le rapport entrerfaces.
-
Alertes & opérations
Abonnez-vous à device hors ligne, alertes de panne de communication et de chargement ; intégrer aux systèmes de billetterie.
-
Projets & access
Isolement des locataires multi-hôtels/projets ; Gestion de l'AppKey, des rôles et de la portée API.
Démarrage rapide
-
Enregistrer un compte développeur
Soumettez une demande d'intégration via les ventes ou l'assistance pour obtenir AppKey / AppSecret.
-
Configurer l'URL de rappel
Enregistrez l'URL du Webhook dans la console du développeur pour connaître l'état de la salle et les événements d'alerte.
-
Intégration du bac à sable
Appelez les API avec l'ID du projet de test pour vérifier les champs de signature, d'authentification et commerciaux.
-
Mise en production
Après avoir acceptéceptance, passez aux informations d'identification de production et surveillez le volume d'appels et les taux d'erreur par SLA.
Points finaux communs
Exemples de chemins REST typiques ; téléchargez la spécification OpenAPI complète à partir du site de centre de téléchargement.
| Méthode | Chemin | Descriptif |
|---|---|---|
| POST | /v1/oauth/token | Obtenir un jeton acceSS (identifiants client) |
| GET | /v1/projects/{id}/rooms | Liste paginée des salles avec résumé de l'état |
| GET | /v1/projects/{id}/rooms/{roomNo}/devices | Devices et statut en ligne d'une salle |
| PUT | /v1/projects/{id}/rooms/{roomNo}/scene/{sceneId} | Déclencheur scene (par exemple, bienvenue, vacanmise hors tension) |
| POST | /v1/projects/{id}/rooms/{roomNo}/points | Points d'écriture par lots (commutateurs, gradation, points de consigne HVAC, etc.) |
| GET | /v1/projects/{id}/energy/summary | Récapitulatif énergétique pour une plage horaire |
| POST | /v1/webhooks/subscriptions | Enregistrez un abonnement Webhook (état de la salle, alertes, etc.) |
Écosystème de protocoles &
Au-delà de HTTP API, les bus de terrain et les plates-formes tierces sont pris en charge pour diverses intégrations d'hôtels et de bâtiments.
BACnet / Modbus
Conversion de protocole pour BMS, HVAC, compteurs et autres sous-systèmes
MQTT
Device reporting et livraison de commandes dans un réseau à faible bande passantecenarios
KNX / plugins d'écosystème
Fonctionne avec KNX, Home Assistant et d'autres solutions d'interconnexion
Progrès de l'intégrationcess
Soumettre la demande
Décrire le scénario d'intégration cenario, le volume d'appels attendu et le calendrier de mise en ligne
Émettre des informations d'identification
Clés du bac à sable et de l'environnement de production attribuées
Test d'intégration
L'assistance technique vous aide avec les tests API et Webhook
Allez en direct
Passer en production et inclure dans la surveillance des opérations
FAQ
Comment puis-je obtenir les clés API ?
Disponibleble pour les intégrateurs sous contrat et les clients stratégiques. Soumettre un brief d'intégration via les ventes ou le support ; après approbation, créez une application dans la console du développeur pour AppKey et AppSecret.
Le déploiement de passerelle locale est-il pris en charge ?
Oui. Les grands groupes hôteliers can utilisent des passerelles périphériques locales avec API cohérents avec le cloud dans des systèmes hors ligne et à faible latencecenarios ; l'architecture est définie par projet.
Y a-t-il des limites de taux ?
Le QPS par défaut et les quotas quotidiens s'appliquent par application ; les projets en masse can demande augmentent. Exceles limites d'édition renvoient 429 – implémente un intervalle exponentiel.
Comment les Webhooks sont-ils sécurisés ?
Les charges utiles des événements incluent la signature HMAC et l'horodatage ; vérifier la signature et rejeter les demandes périmées. Utilisez des points de terminaison HTTPS ; Listes autorisées IP disponiblesble sur demande.
En quoi est-ce différent de la plateforme cloud ?
La plateforme cloud est une opération visuelle pour le personnel ; Le développeur API est destiné à l'intégration et à l'automatisation du système : PMS, CRM, plates-formes énergétiques, etc. Les deux can doivent être utilisés ensemble.
Besoin d'une formation sur site ou d'un support après-vente ?
Nous proposons une formation à l'intégration API, un coaching d'acceptance et une assistance technique sur le cycle de vie complet.
