Info

La API de /osc/info muestra información básica sobre la cámara y la funcionalidad que admite.

Entrada

  • Este comando no admite entradas.

Salida

Nombre Tipo Descripción
manufacturer Cadena El fabricante de la cámara
model Cadena El modelo de la cámara
serialNumber Cadena Número de serie.
firmwareVersion Cadena Versión de firmware actual.
supportUrl Cadena URL de la página web de asistencia de la cámara.
gps Booleano Es verdadero si la cámara tiene GPS.
gyro Booleano Es verdadero si la cámara tiene giroscopio.
uptime Número entero Cantidad de segundos desde el inicio de la cámara.
api Array de strings Lista de APIs compatibles.
endpoints Objeto Un objeto JSON que contiene información sobre los extremos de la cámara. Consulta la siguiente tabla.
apiLevel Array de enteros Es [1] de forma predeterminada cuando falta este campo. [1, 2] representa la admisión de las API 1 y 2 mientras [2] representa la admisión de la API 2 únicamente. Es responsabilidad del desarrollador recuperar esta información y realizar la implementación de forma diferente según el valor. Este campo se agregó en el nivel de API 2. Usa también 2 si admites la API 2.1.
cameraId Cadena Es un ID único que representa a la cámara. Este campo se agregó en el nivel de API 2.1 y es relevante para la carga directa.
_vendorSpecific tipo Información adicional sobre la cámara específica para proveedores Para evitar colisiones de espacios de nombres, debes anteponer un guion bajo ( _ ) a las claves específicas del proveedor.

Objeto endpoints

Este objeto JSON proporciona información sobre los puertos que usa la cámara para los extremos.

Nota: Los extremos HTTPS son opcionales.

Nombre Tipo Descripción
httpPort Número entero Puerto para el servidor HTTP. (El valor predeterminado es 80)
httpUpdatesPort Número entero Puerto para recibir actualizaciones a través de HTTP
httpsPort Número entero (Opcional) Puerto para el servidor HTTPS. (predeterminado 443)
httpsUpdatesPort Número entero Puerto para recibir actualizaciones a través de HTTPS (opcional).

Error

  • Este comando no muestra errores.

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