Step-based focus adjustment

POST

api

cameras

{cameraId}

actions

focus-near-far

Step-based focus adjustment

curl --request POST \
  --url http://{host}:{port}/api/cameras/{cameraId}/actions/focus-near-far \
  --header 'Content-Type: application/json' \
  --data '{
  "step": 0
}'

import requests

url = "http://{host}:{port}/api/cameras/{cameraId}/actions/focus-near-far"

payload = { "step": 0 }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({step: 0})
};

fetch('http://{host}:{port}/api/cameras/{cameraId}/actions/focus-near-far', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "62437",
  CURLOPT_URL => "http://{host}:{port}/api/cameras/{cameraId}/actions/focus-near-far",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'step' => 0
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "http://{host}:{port}/api/cameras/{cameraId}/actions/focus-near-far"

	payload := strings.NewReader("{\n  \"step\": 0\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://{host}:{port}/api/cameras/{cameraId}/actions/focus-near-far")
  .header("Content-Type", "application/json")
  .body("{\n  \"step\": 0\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://{host}:{port}/api/cameras/{cameraId}/actions/focus-near-far")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"step\": 0\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "camera": {
    "connected": false,
    "model": "ILCE-7M4",
    "id": "D06CE05E3323"
  },
  "data": {}
}

{
  "success": false,
  "message": "Camera not connected",
  "camera": {
    "connected": false,
    "model": "ILCE-7M4",
    "id": "D06CE05E3323"
  }
}

Path Parameters

cameraId

string

required

Camera identifier (e.g. D10F60149B0C)

Body

application/json

step

integer

required

Negative = near, positive = far. Magnitude controls speed. 0 is invalid.

Required range: -7 <= x <= 7

Response

Focus command executed

Generic envelope returned by most camera operations. The shape of data varies per endpoint — most operations return an empty or null data; operations that return structured data document a specific shape. SDK-generated types can treat data as an opaque map for generic endpoints.

success

boolean

required

message

string

camera

object

Camera info embedded in API responses

Show child attributes

data

object

Enable live view on cameraSends the SDK `Setting_Key_EnableLiveView` command to the camera.

Step-based focus adjustment

curl --request POST \
  --url http://{host}:{port}/api/cameras/{cameraId}/actions/focus-near-far \
  --header 'Content-Type: application/json' \
  --data '{
  "step": 0
}'

import requests

url = "http://{host}:{port}/api/cameras/{cameraId}/actions/focus-near-far"

payload = { "step": 0 }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({step: 0})
};

fetch('http://{host}:{port}/api/cameras/{cameraId}/actions/focus-near-far', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "62437",
  CURLOPT_URL => "http://{host}:{port}/api/cameras/{cameraId}/actions/focus-near-far",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'step' => 0
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "http://{host}:{port}/api/cameras/{cameraId}/actions/focus-near-far"

	payload := strings.NewReader("{\n  \"step\": 0\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://{host}:{port}/api/cameras/{cameraId}/actions/focus-near-far")
  .header("Content-Type", "application/json")
  .body("{\n  \"step\": 0\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://{host}:{port}/api/cameras/{cameraId}/actions/focus-near-far")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"step\": 0\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "<string>",
  "camera": {
    "connected": false,
    "model": "ILCE-7M4",
    "id": "D06CE05E3323"
  },
  "data": {}
}

{
  "success": false,
  "message": "Camera not connected",
  "camera": {
    "connected": false,
    "model": "ILCE-7M4",
    "id": "D06CE05E3323"
  }
}

Server

Connection

Properties

Actions

Live View

Events

SD Card

Settings

Path Parameters

Body

Response