API 参考

# Step 1: 获取 Access Token
curl -X POST https://api.ponylab.io/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"your_password"}'

# Response:
# {
#   "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
#   "refresh_token": "rt_xxxxxxxxxxxxxxxx",
#   "expires_in": 3600
# }

# Step 2: 使用 Access Token
curl https://api.ponylab.io/v1/experiments \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "data": { ... },         // 单个资源
  // 或
  "data": [ ... ],         // 资源列表
  "total": 142,            // 总数（仅列表接口）
  "page": 1,
  "limit": 20
}

{
  "error": "VALIDATION_ERROR",
  "message": "title is required",
  "errors": [
    { "field": "title", "message": "title is required" }
  ],
  "requestId": "req_01HXYZ123"
}

curl -X POST https://api.ponylab.io/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "your_secure_password"
  }'

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "rt_01HXYZ123456789",
  "expires_in": 3600,
  "token_type": "Bearer",
  "user": {
    "id": "user_abc123",
    "email": "[email protected]",
    "name": "Dr. Zhang Wei",
    "currentTeamId": "team_xyz789"
  }
}

// 请求 Body
{
  "title": "HEK293T 细胞 MTT 活力检测 — 化合物 A",
  "description": "评估化合物 A 对 HEK293T 的细胞毒性",
  "status": "IN_PROGRESS",
  "directionId": "dir_abc",         // 研究方向 ID
  "sampleIds": ["smp_001", "smp_002"],
  "tags": ["MTT", "细胞毒性", "化合物A"]
}

{
  "data": {
    "id": "exp_01HXYZ789",
    "title": "HEK293T 细胞 MTT 活力检测 — 化合物 A",
    "status": "IN_PROGRESS",
    "createdBy": { "id": "user_abc", "name": "Dr. Zhang Wei" },
    "createdAt": "2026-03-20T08:30:00Z",
    "updatedAt": "2026-03-20T08:30:00Z",
    "directionId": "dir_abc",
    "sampleIds": ["smp_001", "smp_002"],
    "signatureCount": 0,
    "attachmentCount": 0
  }
}

// 请求 Body（需要密码二次验证）
{
  "password": "your_current_password",
  "role": "AUTHOR",              // AUTHOR | WITNESS
  "statement": "I confirm this experiment is accurate and complete."
}

// 响应（200 OK）
{
  "data": {
    "signatureId": "sig_01HXYZ",
    "experimentId": "exp_01HXYZ789",
    "signedBy": { "id": "user_abc", "name": "Dr. Zhang Wei" },
    "role": "AUTHOR",
    "signedAt": "2026-03-20T10:00:00Z",
    "hash": "sha256:a3f8b2c1..."
  }
}

// 请求 Body
{
  "type": "OUT",             // IN | OUT | ADJUST | DISCARD
  "quantity": 5,             // 调整数量（OUT/DISCARD 为扣除量，ADJUST 为绝对值）
  "unit": "mL",
  "reason": "Western Blot 实验使用",
  "experimentId": "exp_01HXYZ789",  // 可选：关联到具体实验
  "date": "2026-03-20T09:00:00Z"
}

// 响应（200 OK）
{
  "data": {
    "adjustmentId": "adj_01",
    "inventoryId": "inv_xxx",
    "type": "OUT",
    "quantity": 5,
    "previousQuantity": 50,
    "newQuantity": 45,
    "performedBy": { "id": "user_abc", "name": "Dr. Zhang Wei" },
    "createdAt": "2026-03-20T09:00:00Z"
  }
}

// 请求 Body
{
  "experimentId": "exp_01HXYZ789",
  "messages": [
    {
      "role": "user",
      "content": "请分析 CSV 附件中各组的均值和标准差，判断是否有统计学差异"
    }
  ],
  "model": "claude-3-5-sonnet-20241022"  // 可选，覆盖团队默认模型
}

// 响应（200 OK）
{
  "data": {
    "message": {
      "role": "assistant",
      "content": "根据上传的 CSV 数据分析...[完整 AI 回复]"
    },
    "usage": {
      "input_tokens": 3240,
      "output_tokens": 512
    }
  }
}

// 请求 Body
{
  "query": "上个月所有使用 HEK293T 细胞的已完成实验",
  "returnSql": true  // 可选：在响应中返回生成的 SQL（供调试）
}

// 响应（200 OK）
{
  "data": {
    "results": [
      { "id": "exp_001", "title": "...", "completedAt": "2026-02-15T..." },
      ...
    ],
    "total": 7,
    "generatedSql": "SELECT * FROM experiments WHERE ...",  // 仅 returnSql=true 时返回
    "executionTime": "142ms"
  }
}

curl -X POST https://api.ponylab.io/v1/billing/checkout \
  -H "Authorization: Bearer pl_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "plan": "PRO",
    "successUrl": "https://app.ponylab.io/settings/billing?success=true",
    "cancelUrl": "https://app.ponylab.io/settings/billing"
  }'

# 响应
# {
#   "data": {
#     "checkoutUrl": "https://checkout.stripe.com/c/pay/cs_live_..."
#   }
# }
# 将用户重定向到 checkoutUrl 完成支付

curl -X POST https://api.ponylab.io/v1/webhooks \
  -H "Authorization: Bearer pl_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "ERP 集成通知",
    "url": "https://your-server.example.com/ponylab/events",
    "events": [
      "experiment.signed",
      "sample.created",
      "inventory.low_stock",
      "capa.created",
      "task.overdue"
    ],
    "secret": "your_32_char_random_secret_here_xxxx",
    "active": true
  }'

{
  "id": "evt_01HXYZ123456",
  "event": "experiment.signed",
  "timestamp": "2026-03-20T10:30:00.000Z",
  "teamId": "team_abc123",
  "teamName": "王教授课题组",
  "data": {
    "experimentId": "exp_xyz789",
    "experimentTitle": "PCR BRCA1 扩增",
    "signatureId": "sig_001",
    "signedBy": {
      "id": "user_abc",
      "name": "Dr. Zhang Wei",
      "email": "[email protected]",
      "role": "RESEARCHER"
    },
    "signatureRole": "AUTHOR",
    "signedAt": "2026-03-20T10:29:58.000Z"
  },
  "apiVersion": "v1"
}

# 使用 openapi-generator 从 OpenAPI Schema 自动生成客户端
npx openapi-generator-cli generate \
  -i https://api.ponylab.io/v1/openapi.json \
  -g typescript-fetch \
  -o ./ponylab-client

# 或者使用 Python 版本
pip install openapi-python-client
openapi-python-client generate \
  --url https://api.ponylab.io/v1/openapi.json