Write Joint Positions
curl --request POST \
--url https://api.example.com/joints/write \
--header 'Content-Type: application/json' \
--data '
{
"angles": [
123
],
"joints_ids": [
123
],
"unit": "rad"
}
'import requests
url = "https://api.example.com/joints/write"
payload = {
"angles": [123],
"joints_ids": [123],
"unit": "rad"
}
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({angles: [123], joints_ids: [123], unit: 'rad'})
};
fetch('https://api.example.com/joints/write', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/joints/write",
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([
'angles' => [
123
],
'joints_ids' => [
123
],
'unit' => 'rad'
]),
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 := "https://api.example.com/joints/write"
payload := strings.NewReader("{\n \"angles\": [\n 123\n ],\n \"joints_ids\": [\n 123\n ],\n \"unit\": \"rad\"\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("https://api.example.com/joints/write")
.header("Content-Type", "application/json")
.body("{\n \"angles\": [\n 123\n ],\n \"joints_ids\": [\n 123\n ],\n \"unit\": \"rad\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/joints/write")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"angles\": [\n 123\n ],\n \"joints_ids\": [\n 123\n ],\n \"unit\": \"rad\"\n}"
response = http.request(request)
puts response.read_body{
"message": "<string>",
"status": "ok"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Control
Write Joint Positions
Move the robot’s joints to the specified angles.
POST
/
joints
/
write
Write Joint Positions
curl --request POST \
--url https://api.example.com/joints/write \
--header 'Content-Type: application/json' \
--data '
{
"angles": [
123
],
"joints_ids": [
123
],
"unit": "rad"
}
'import requests
url = "https://api.example.com/joints/write"
payload = {
"angles": [123],
"joints_ids": [123],
"unit": "rad"
}
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({angles: [123], joints_ids: [123], unit: 'rad'})
};
fetch('https://api.example.com/joints/write', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/joints/write",
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([
'angles' => [
123
],
'joints_ids' => [
123
],
'unit' => 'rad'
]),
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 := "https://api.example.com/joints/write"
payload := strings.NewReader("{\n \"angles\": [\n 123\n ],\n \"joints_ids\": [\n 123\n ],\n \"unit\": \"rad\"\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("https://api.example.com/joints/write")
.header("Content-Type", "application/json")
.body("{\n \"angles\": [\n 123\n ],\n \"joints_ids\": [\n 123\n ],\n \"unit\": \"rad\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/joints/write")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"angles\": [\n 123\n ],\n \"joints_ids\": [\n 123\n ],\n \"unit\": \"rad\"\n}"
response = http.request(request)
puts response.read_body{
"message": "<string>",
"status": "ok"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Query Parameters
Body
application/json
Request to set the joints of the robot.
A list with the position of each joint. The length of the list must be equal to the number of joints. The unit is given by the 'unit' field.
If set, only set the joints with these ids. If None, set all joints.Example: 'angles'=[1,1,1], 'joints_ids'=[0,1,2] will set the first 3 joints to 1 radian.
The unit of the angles. Defaults to radian.
Available options:
rad, motor_units, degrees Was this page helpful?
⌘I