Guide Try-it de l'API

Chaque page produit de la référence d’API est accompagnée d’une console Playground (Try-it). Vous pouvez appeler directement l’API REST de l’appareil depuis le navigateur et en consulter la réponse ; chaque opération dispose en outre d’un bouton copy-as-curl (copie de la commande cURL), qui permet d’exécuter la même requête depuis un terminal, y compris dans les environnements où l’appel direct est difficile.

1. Saisie de l’adresse de l’appareil

Dans la variable de serveur device_ip située en haut du Playground, saisissez l’adresse IP de l’appareil cible (par exemple 192.168.0.30). L’appareil servant lui-même l’API, l’adresse doit être accessible au sein du même réseau (ou via une liaison directe P2P).

2. Prise en charge des navigateurs

Navigateur	Appel direct depuis le navigateur	Conditions
Chrome / Edge 142+	Possible	Après avoir accordé une première fois l’autorisation d’accès au réseau local (LNA) pour les adresses IP privées
Firefox 149/151+	Généralement possible	Même modèle LNA, déploiement progressif en cours
Safari	Impossible	Contenu mixte bloqué sur les réseaux privés — utilisez copy-as-curl

💡 Remarque : ce site de documentation est en HTTPS, tandis que l’API de l’appareil est en HTTP sur le réseau privé. Chrome/Edge 142+ exemptent automatiquement le contenu mixte lorsque la cible est une adresse IP privée littérale et affichent une première fois une invite d’autorisation d’accès au réseau local (LNA). Une fois l’autorisation accordée, les appels s’effectuent normalement.

3. Lorsque l’appel direct est bloqué — solution de repli copy-as-curl

Si vous utilisez Safari ou un navigateur ancien, ou si une requête cross-origin comportant une authentification (Basic Auth) est bloquée par la politique du navigateur, copiez la commande cURL à l’aide du bouton copy-as-curl de chaque opération, puis exécutez-la dans un terminal. Le comportement est identique dans tous les navigateurs et tous les environnements.

curl -u admin:<password> http://192.168.0.30/setting/status

4. Résolution des problèmes

• Si l’invite LNA ne s’affiche pas ou si vous l’avez refusée → autorisez l’accès au réseau local dans les autorisations de site du navigateur.

• Safari bloque le contenu mixte sur les réseaux privés : l’appel direct y est donc impossible → utilisez copy-as-curl.

• Pour les requêtes nécessitant une authentification, saisissez le nom d’utilisateur et le mot de passe. Le compte par défaut de l’appareil doit impérativement être modifié lors de la première connexion.