/osc/info
API, desteklediği kamera ve işlevlerle ilgili temel bilgileri döndürür.
Giriş
- Bu komuta herhangi bir giriş yapılmaz.
Çıkış
Ad | Tür | Açıklama |
---|---|---|
manufacturer |
Dize | Kamera üreticisi. |
model |
Dize | Kamera modeli. |
serialNumber |
Dize | Seri numarası. |
firmwareVersion |
Dize | Mevcut donanım yazılımı sürümü. |
supportUrl |
Dize | Kameranın destek web sayfasının URL'si. |
gps |
Boole | Kamerada GPS varsa doğru değerini alır. |
gyro |
Boole | Kamerada jiroskop varsa doğru değerini alır. |
uptime |
Tamsayı | Kamera başlatıldıktan sonra geçen saniye sayısı. |
api |
Dize Dizisi | Desteklenen API'lerin listesi. |
endpoints |
Nesne | Kameranın uç noktalarıyla ilgili bilgiler içeren bir JSON nesnesi. Sonraki tabloya bakın. |
apiLevel |
Tam Sayı Dizisi | Bu alan eksik olduğunda varsayılan olarak [1] değerini alır. [1, 2] hem API 1 hem de 2 desteklenir, [2] ise yalnızca API 2'yi temsil eder. Bu bilgileri almak ve değere göre farklı şekilde uygulamak geliştiricinin sorumluluğundadır. Bu alan, API düzeyi 2'de eklenmiştir. API 2.1'i destekliyorsanız lütfen 2'yi de kullanın. |
cameraId |
Dize | Kamerayı temsil eden benzersiz bir kimlik. Bu alan, API düzeyi 2.1'de eklenmiştir ve Doğrudan Yükleme ile ilgilidir. |
_vendorSpecific |
tür | Kamera hakkında satıcıya özel ek bilgiler. Lütfen tedarikçiye özel anahtarların önüne alt çizgi ( _ ) koyarak ad alanı çakışmalarını önleyin. |
endpoints
nesne
Bu JSON nesnesi, kameranın uç noktalar için kullandığı bağlantı noktaları hakkında bilgi sağlar.
Not: HTTPS uç noktaları isteğe bağlıdır.
Ad | Tür | Açıklama |
---|---|---|
httpPort |
Tamsayı | HTTP sunucusu bağlantı noktası. (Varsayılan 80) |
httpUpdatesPort |
Tamsayı | HTTP üzerinden güncellemeleri almak için bağlantı noktası |
httpsPort |
Tamsayı | (İsteğe bağlı) HTTPs sunucusu için bağlantı noktası. (Varsayılan 443) |
httpsUpdatesPort |
Tamsayı | (İsteğe bağlı) HTTPS üzerinden güncelleme almak için bağlantı noktası. |
Hata
- Bu komut hata döndürmez.
Örnek |
|
---|---|
İstek | GET /osc/info HTTP/1.1 Host: [camera ip address]:[httpPort] Accept: application/json X-XSRF-Protected: 1 |
Yanıt (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] } |
Yanıt (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" ] } |