Información

La API /osc/info devuelve información básica acerca de 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 Dirección URL de la página web de soporte de la cámara.
gps Valor booleano “True” si la cámara tiene GPS.
gyro Valor booleano “True” si la cámara tiene giroscopio.
uptime Entero Segundos desde el arranque de la cámara.
api Matriz de cadena Lista de API admitidas.
endpoints Objeto Un objeto JSON que contiene información acerca de los puntos finales de la cámara. Consulta la siguiente tabla.
apiLevel Matriz de números 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.
_vendorSpecific [tipo] (opcional) Información adicional acerca de la cámara específica para proveedores. Para las claves específicas de proveedores, usa el prefijo guión bajo ( _ ) para evitar colisiones de espacio de nombres.

Objeto endpoints

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

Nombre Tipo Descripción
httpPort Entero Puerto para el servidor HTTP. (de forma predeterminada, 80)
httpUpdatesPort Entero Puerto para recibir actualizaciones a través de HTTP
httpsPort Entero (Opcional) Puerto para el servidor HTTPs. (de forma predeterminada, 443)
httpsUpdatesPort Entero (Opcional) Puerto para recibir actualizaciones a través de HTTPs.

Error

  • Este comando no devuelve 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"
        ]
}