Info

L'API /osc/info restituisce informazioni di base sulla fotocamera e sulla 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 di 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 intero Quando questo campo non è presente, il valore predefinito è [1]. [1, 2] rappresenta il supporto di API 1 e 2, mentre [2] rappresenta solo l'API 2. È responsabilità dello sviluppatore recuperare queste informazioni e implementarle in modo diverso in base al valore. Questo campo è stato aggiunto nel livello API 2. Utilizza anche 2 se supporti l'API 2.1.
cameraId Stringa Un ID univoco che rappresenta la fotocamera. Questo campo è stato aggiunto nel livello API 2.1 ed è pertinente al caricamento diretto.
_vendorSpecific type Informazioni aggiuntive sulla fotocamera specifiche del fornitore. Aggiungi un trattino basso ( _) alle chiavi specifiche del fornitore per evitare conflitti con lo spazio dei nomi.

endpoints oggetto

Questo oggetto JSON fornisce informazioni sulle porte utilizzate dalla fotocamera 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. (443 predefinita)
httpsUpdatesPort Numero intero (Facoltativo) Porta per la ricezione degli 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"
        ]
}