Developer Image

Overview

HTTP OpenAPI for Developer Disk Image (DDI) operations. Matches script helpers utils · Developer Image (mountDevImage / unmountDevImage / checkDevImage).

After a device reboot the image usually unmounts and must be loaded again. If USB HID sessionStart remounts a newer image and automation then fails, unmount then mount before restarting automation. See USB HID.

Mount developer image

POST /openapi/mountDevImage

1
{
2
  "deviceId": "6a290cdc0b6db0565955355b157acc090e33f76e"
3
}

Examples

1
import requests
2

3
body = {"deviceId": "6a290cdc0b6db0565955355b157acc090e33f76e"}
4
r = requests.post("http://127.0.0.1:8019/openapi/mountDevImage", json=body, timeout=180)
5
print(r.json())

1
const body = { deviceId: "6a290cdc0b6db0565955355b157acc090e33f76e" };
2
const res = await fetch("http://127.0.0.1:8019/openapi/mountDevImage", {
3
  method: "POST",
4
  headers: { "Content-Type": "application/json" },
5
  body: JSON.stringify(body),
6
});
7
console.log(await res.json());

1
curl -s -X POST "http://127.0.0.1:8019/openapi/mountDevImage" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"6a290cdc0b6db0565955355b157acc090e33f76e"}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(180) };
3
var json = "{\"deviceId\":\"6a290cdc0b6db0565955355b157acc090e33f76e\"}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/mountDevImage", content);
6
Console.WriteLine(await res.Content.ReadAsStringAsync());

Response

1
{
2
  "code": 0,
3
  "msg": "",
4
  "data": true
5
}

Unmount developer image

POST /openapi/unmountDevImage

1
{
2
  "deviceId": "6a290cdc0b6db0565955355b157acc090e33f76e"
3
}

Examples

1
import requests
2

3
body = {"deviceId": "6a290cdc0b6db0565955355b157acc090e33f76e"}
4
r = requests.post("http://127.0.0.1:8019/openapi/unmountDevImage", json=body, timeout=180)
5
print(r.json())

1
const body = { deviceId: "6a290cdc0b6db0565955355b157acc090e33f76e" };
2
const res = await fetch("http://127.0.0.1:8019/openapi/unmountDevImage", {
3
  method: "POST",
4
  headers: { "Content-Type": "application/json" },
5
  body: JSON.stringify(body),
6
});
7
console.log(await res.json());

1
curl -s -X POST "http://127.0.0.1:8019/openapi/unmountDevImage" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"6a290cdc0b6db0565955355b157acc090e33f76e"}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(180) };
3
var json = "{\"deviceId\":\"6a290cdc0b6db0565955355b157acc090e33f76e\"}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/unmountDevImage", content);
6
Console.WriteLine(await res.Content.ReadAsStringAsync());

Response

1
{
2
  "code": 0,
3
  "msg": "",
4
  "data": true
5
}

Check mount status

POST /openapi/checkDevImage

Query only — does not auto-mount.

1
{
2
  "deviceId": "6a290cdc0b6db0565955355b157acc090e33f76e"
3
}

Examples

1
import requests
2

3
body = {"deviceId": "6a290cdc0b6db0565955355b157acc090e33f76e"}
4
r = requests.post("http://127.0.0.1:8019/openapi/checkDevImage", json=body, timeout=60)
5
print(r.json())

1
const body = { deviceId: "6a290cdc0b6db0565955355b157acc090e33f76e" };
2
const res = await fetch("http://127.0.0.1:8019/openapi/checkDevImage", {
3
  method: "POST",
4
  headers: { "Content-Type": "application/json" },
5
  body: JSON.stringify(body),
6
});
7
console.log(await res.json());

1
curl -s -X POST "http://127.0.0.1:8019/openapi/checkDevImage" \
2
  -H "Content-Type: application/json" \
3
  -d '{"deviceId":"6a290cdc0b6db0565955355b157acc090e33f76e"}'

1
using System.Text;
2
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(60) };
3
var json = "{\"deviceId\":\"6a290cdc0b6db0565955355b157acc090e33f76e\"}";
4
using var content = new StringContent(json, Encoding.UTF8, "application/json");
5
using var res = await http.PostAsync("http://127.0.0.1:8019/openapi/checkDevImage", content);
6
Console.WriteLine(await res.Content.ReadAsStringAsync());

Response

1
{
2
  "code": 0,
3
  "msg": "",
4
  "data": {
5
    "mounted": true,
6
    "result": true,
7
    "path": "/path/to/DeveloperDiskImage.dmg"
8
  }
9
}

Field	Type	Description
data.mounted	boolean	Whether the image is mounted
data.result	boolean	Same as `mounted`
data.path	string	Image path when mounted; empty when not