Informations

L'API /osc/info renvoie des informations de base sur l'appareil photo et ses fonctionnalités. qu'il prend en charge.

Entrée

  • Cette commande ne nécessite aucune entrée.

Sortie

Nom Type Description
manufacturer Chaîne Le fabricant de la caméra.
model Chaîne Modèle de l'appareil photo.
serialNumber Chaîne Numéro de série.
firmwareVersion Chaîne Version actuelle du micrologiciel.
supportUrl Chaîne URL de la page Web d'assistance dédiée à la caméra.
gps Booléen Vrai si l'appareil photo est équipé d'un GPS.
gyro Booléen Vrai si l'appareil photo est équipé d'un gyroscope.
uptime Entier Nombre de secondes écoulées depuis le démarrage de la caméra.
api Tableau de chaînes Liste des API compatibles.
endpoints Objet Objet JSON contenant des informations sur les points de terminaison de la caméra. Consultez le tableau suivant.
apiLevel Tableau d'entiers Si ce champ n'est pas renseigné, sa valeur est [1] par défaut. [1, 2] signifie que les API 1 et 2 sont prises en charge tandis que [2] signifie que seulement l'API 2 est prise en charge. Il relève de la responsabilité du développeur d'extraire cette information et d'adapter l'implémentation selon cette valeur. Ce champ a été ajouté au niveau d'API 2. Veuillez également utiliser la valeur 2 si votre API est compatible avec la version 2.1.
cameraId Chaîne Identifiant unique représentant l'appareil photo. Ce champ a été ajouté au niveau d'API 2.1 et concerne l'importation directe.
_vendorSpecific type Informations supplémentaires spécifiques au fournisseur concernant la caméra. Veuillez ajouter un trait de soulignement ( _ ) avant les clés spécifiques au fournisseur pour éviter les conflits d'espaces de noms.

Objet endpoints

Cet objet JSON fournit des informations sur les ports que la caméra utilise pour les points de terminaison.

Remarque: Les points de terminaison HTTPS sont facultatifs.

Nom Type Description
httpPort Entier Port du serveur HTTP. (80 par défaut)
httpUpdatesPort Entier Port de réception des mises à jour via HTTP
httpsPort Entier (Facultatif) Port pour le serveur HTTPS. (443 par défaut)
httpsUpdatesPort Entier (Facultatif) Port permettant de recevoir des mises à jour via HTTPS.

Erreur

  • Cette commande ne renvoie aucune erreur.

Exemple
Requête 
GET /osc/info HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
Réponse (API 2) 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
        "manufacturer": "AAA",
        "model": "BBB",
        "serialNumber": "CCC",
        "firmwareVersion": "DDD",
        "supportUrl": "EEE",
        "endpoints": {
            "httpPort": 80,
            "httpUpdatesPort": 10080,
            ...
        },
        "gps": true,
        "gyro": false,
        "uptime": 600,
        "api": [
            "/osc/info",
            "/osc/state",
            "/osc/checkForUpdates",
            "/osc/commands/execute",
            "/osc/commands/status"
        ],
        "apiLevel": [1, 2]
}
Réponse (API 1) 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
        "manufacturer": "AAA",
        "model": "BBB",
        "serialNumber": "CCC",
        "firmwareVersion": "DDD",
        "supportUrl": "EEE",
        "endpoints": {
            "httpPort": 80,
            "httpUpdatesPort": 10080,
            ...
        },
        "gps": true,
        "gyro": false,
        "uptime": 600,
        "api": [
            "/osc/info",
            "/osc/state",
            "/osc/checkForUpdates",
            "/osc/commands/execute",
            "/osc/commands/status"
        ]
}