API reference

KEY="ea_live_…"
API="https://electronics-architect.com"

cat > design.json <<'EOF'
{
  "schemaVersion": 1, "version": "3.0",
  "sheets": [{
    "id": "sheet-1", "name": "12 V to 5 V",
    "nodes": [
      { "id": "src",  "type": "Source", "name": "V1", "x": 0,   "y": 0,
        "properties": { "voltage": 12, "currentLimit": 2, "internalR": 0.05 }, "portDirections": { "right": "out" } },
      { "id": "ldo",  "type": "LDO",    "name": "U1", "x": 240, "y": 0,
        "properties": { "vinMin": 6, "outputVoltage": 5, "dropout": 0.5, "iq": 0.0001, "vinMax": 20,
                        "iMax": 1, "pdMax": 1.5, "thetaJA": 60, "tMax": 125 },
        "portDirections": { "left": "in", "right": "out" } },
      { "id": "load", "type": "Load",   "name": "L1", "x": 480, "y": 0,
        "properties": { "current": 0.1 }, "portDirections": { "left": "in" } }
    ],
    "connections": [
      { "from": { "nodeId": "src", "side": "right" }, "to": { "nodeId": "ldo",  "side": "left" } },
      { "from": { "nodeId": "ldo", "side": "right" }, "to": { "nodeId": "load", "side": "left" } }
    ]
  }]
}
EOF

# 1. Create the cloud design (retry-safe with an Idempotency-Key)
ID=$(jq -n --slurpfile d design.json '{name: "Agent LDO", design: $d[0]}' \
  | curl -s -X POST "$API/v1/designs" -H "Authorization: Bearer $KEY" \
         -H "Content-Type: application/json" -H "Idempotency-Key: run-001" -d @- | jq -r .id)

# 2. Solve the nominal corner
jq -n --slurpfile d design.json '{design: $d[0], options: {corner: "nom"}}' \
  | curl -s -X POST "$API/v1/designs/solve" -H "Authorization: Bearer $KEY" \
         -H "Content-Type: application/json" -d @- \
  | jq '.result.sheets[0] | {converged, warnings: [.warnings[] | {code, level, remedy}]}'

# 3. Monte Carlo, seeded so it can be reproduced (metered)
jq -n --slurpfile d design.json '{design: $d[0], options: {trials: 500, seed: 42}}' \
  | curl -s -X POST "$API/v1/designs/monte-carlo" -H "Authorization: Bearer $KEY" \
         -H "Content-Type: application/json" -d @- | jq '.meta'

# 4. Export the bill of materials as CSV
curl -s -X POST "$API/v1/designs/$ID/exports" -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/json" -d '{"type":"bom_csv"}' | jq -r .content

import json, requests

API = "https://electronics-architect.com"
H = {"Authorization": "Bearer ea_live_…"}

with open("design.json") as f:          # the document from the curl tab
    design = json.load(f)

def call(method, path, **kw):
    r = requests.request(method, API + path, headers=H, **kw)
    body = r.json()
    if not r.ok:
        err = body["error"]
        raise RuntimeError(f'{r.status_code} {err["code"]}: {err["message"]}')
    return body

# 1. Create
created = call("POST", "/v1/designs",
               json={"name": "Agent LDO", "design": design},
               headers={**H, "Idempotency-Key": "run-001"})
design_id = created["id"]

# 2. Solve
solved = call("POST", "/v1/designs/solve", json={"design": design, "options": {"corner": "nom"}})
sheet = solved["result"]["sheets"][0]
print("converged:", sheet["converged"])
for w in sheet["warnings"]:
    print(f'  [{w["level"]}] {w["code"]}: {w["remedy"]}')

# 3. Monte Carlo (metered; 402 QUOTA_EXHAUSTED when the month's runs are used up)
mc = call("POST", "/v1/designs/monte-carlo", json={"design": design, "options": {"trials": 500, "seed": 42}})
print("trials:", mc["meta"]["trials"], "seed:", mc["meta"]["seed"])

# 4. Export the BOM
bom = call("POST", f"/v1/designs/{design_id}/exports", json={"type": "bom_csv"})
open(bom["filename"], "w", newline="").write(bom["content"])

import { readFile, writeFile } from "node:fs/promises";

const API = "https://electronics-architect.com";
const KEY = "ea_live_…";

async function call<T>(method: string, path: string, body?: unknown, extra: Record<string, string> = {}): Promise<T> {
  const res = await fetch(API + path, {
    method,
    headers: { Authorization: `Bearer ${KEY}`, "Content-Type": "application/json", ...extra },
    body: body === undefined ? undefined : JSON.stringify(body),
  });
  const json = await res.json();
  if (!res.ok) throw new Error(`${res.status} ${json.error.code}: ${json.error.message}`);
  return json as T;
}

const design = JSON.parse(await readFile("design.json", "utf8"));   // the document from the curl tab

// 1. Create
const { id } = await call<{ id: string }>("POST", "/v1/designs",
  { name: "Agent LDO", design }, { "Idempotency-Key": "run-001" });

// 2. Solve
const solved = await call<{ result: { sheets: Array<{ converged: boolean; warnings: Array<{ code: string; level: string; remedy?: string }> }> } }>(
  "POST", "/v1/designs/solve", { design, options: { corner: "nom" } });
console.log("converged:", solved.result.sheets[0].converged);
for (const w of solved.result.sheets[0].warnings) console.log(`  [${w.level}] ${w.code}: ${w.remedy ?? ""}`);

// 3. Monte Carlo
const mc = await call<{ meta: { trials: number; seed: number } }>(
  "POST", "/v1/designs/monte-carlo", { design, options: { trials: 500, seed: 42 } });
console.log("trials:", mc.meta.trials, "seed:", mc.meta.seed);

// 4. Export
const bom = await call<{ filename: string; content: string }>("POST", `/v1/designs/${id}/exports`, { type: "bom_csv" });
await writeFile(bom.filename, bom.content);