Info

L'API /osc/info restituisce informazioni di base sulla fotocamera e sulle funzionalità che supporta.

Input

  • Questo comando non accetta input.

Output

Nome Tipo Descrizione
manufacturer Stringa Il produttore della fotocamera.
model Stringa Il modello della fotocamera.
serialNumber Stringa Numero di serie.
firmwareVersion Stringa Versione firmware corrente.
supportUrl Stringa URL della pagina web di assistenza della videocamera.
gps Booleano True se la fotocamera dispone del GPS.
gyro Booleano True se la fotocamera dispone di un giroscopio.
uptime Numero intero Numero di secondi dall'avvio della fotocamera.
api Array di stringhe Elenco delle API supportate.
endpoints Oggetto Un oggetto JSON contenente informazioni sugli endpoint della videocamera. Consulta la tabella successiva.
apiLevel Array di numeri interi Se questo campo non è presente, il valore predefinito è [1]. [1, 2] rappresenta sia API 1 che 2 sono supportati, mentre [2] rappresenta solo API 2 è supportato. È responsabilità dello sviluppatore recuperare queste informazioni e implementarle in modo diverso in base al valore. Questo campo è stato aggiunto al livello API 2. Utilizza anche 2 se supporti l'API 2.1.
cameraId Stringa Un ID univoco che rappresenta la videocamera. Questo campo è stato aggiunto nel livello API 2.1 ed è pertinente al caricamento diretto.
_vendorSpecific type Informazioni aggiuntive specifiche del fornitore sulla videocamera. Per evitare collisioni dello spazio dei nomi, anteponi alle chiavi specifiche del fornitore un trattino basso ( _).

endpoints oggetto

Questo oggetto JSON fornisce informazioni sulle porte utilizzate dalla videocamera per gli endpoint.

Nota: gli endpoint HTTPS sono facoltativi.

Nome Tipo Descrizione
httpPort Numero intero Porta per il server HTTP. (valore predefinito: 80)
httpUpdatesPort Numero intero Porta per ricevere aggiornamenti su HTTP
httpsPort Numero intero (Facoltativo) Porta per il server HTTPS. (valore predefinito 443)
httpsUpdatesPort Numero intero (Facoltativo) Porta per la ricezione di aggiornamenti tramite HTTPS.

Errore

  • Questo comando non restituisce errori.

Esempio
Richiedi 
GET /osc/info HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
Risposta (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]
}
Risposta (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"
        ]
}