快速开始
完成首次登录、创建 Key、选择空间，然后发布第一张工单。
1. 首次登录
点击顶部“进入工作台”完成统一登录。API 不自动创建账号或空间；尚未开通的 Key 用户会收到 account_setup_required。
2. 创建统一 Key
前往 https://login.lingtuzaowu.com/account/api-keys 创建 Key，勾选小工单应用。若应用尚不可选，请等待应用管理员完成接入启用。
明文仅在中心创建时展示一次，将它保存在工具的安全凭证配置中。后端的 Client Secret 不需要、也不能交给 Agent。
3. 选择空间并调用
先请求 GET /api/v1/me，再请求 GET /api/v1/workspaces。从返回的 data 数组取出空间 ID，明确放入后续接口路径。
所有写请求提供 Idempotency-Key。一次逻辑操作固定使用同一个 Key；重试时保持路径、方法和内容一致。
cURL · 发现空间
# 将变量配置到本地安全环境，不要将真实 Key 写入脚本
export XGD_BASE_URL="https://xgd.ailingtu.cn"
curl "$XGD_BASE_URL/api/v1/me" \
-H "Authorization: Bearer $AGENT_API_KEY"
curl "$XGD_BASE_URL/api/v1/workspaces" \
-H "Authorization: Bearer $AGENT_API_KEY"JavaScript · 发布工单
// AGENT_API_KEY、WORKSPACE_ID 由安全环境提供
const response = await fetch(
`${process.env.XGD_BASE_URL}/api/v1/workspaces/${process.env.WORKSPACE_ID}/tickets`,
{
method: "POST",
headers: {
Authorization: `Bearer ${process.env.AGENT_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(), // 重试复用此值
},
body: JSON.stringify({ content: "请跟进首页文案调整" }),
},
);
const result = await response.json();
if (!response.ok) throw new Error(`${result.error.code}: ${result.error.message}`);
console.log(result.data);