# Adaptyv API 参考
## 基础 URL
https://kq5jp7qj7wdqklhsxmovkzn4l40obksv.lambda-url.eu-central-1.on.aws
## 身份验证
所有 API 请求均需在请求头中包含 Bearer Token 身份验证：
Authorization: Bearer YOUR_API_KEY
获取 API 访问权限：
1. 联系
[email protected]
2. 在 alpha/beta 期间申请 API 访问权限
3. 获取您的个人访问令牌
请安全存储您的 API 密钥：
- 使用环境变量：`ADAPTYV_API_KEY`
- 切勿将 API 密钥提交到版本控制系统
- 本地开发请使用包含 `.env` 文件的 `.gitignore`
## 端点 (Endpoints)
### 实验 (Experiments)
#### 创建实验
提交蛋白质序列进行实验测试。
**端点：** `POST /experiments`
**请求体：**
{
"sequences": ">protein1nMKVLWALLGLLGAA...n>protein2nMATGVLWALLG...",
"experiment_type": "binding|expression|thermostability|enzyme_activity",
"target_id": "optional_target_identifier",
"webhook_url": "https://your-webhook.com/callback",
"metadata": {
"project": "optional_project_name",
"notes": "optional_notes"
}
}
**序列格式：**
- 带有标题的 FASTA 格式
- 支持多条序列
- 标准氨基酸代码
**响应：**
{
"experiment_id": "exp_abc123xyz",
"status": "submitted",
"created_at": "2025-11-24T10:00:00Z",
"estimated_completion": "2025-12-15T10:00:00Z"
}
#### 获取实验状态
检查实验的当前状态。
**端点：** `GET /experiments/{experiment_id}`
**响应：**
{
"experiment_id": "exp_abc123xyz",
"status": "submitted|processing|completed|failed",
"created_at": "2025-11-24T10:00:00Z",
"updated_at": "2025-11-25T14:30:00Z",
"progress": {
"stage": "sequencing|expression|assay|analysis",
"percentage": 45
}
}
**状态值：**
- `submitted` - 实验已接收并进入队列
- `processing` - 正在进行测试
- `completed` - 结果可供下载
- `failed` - 实验遇到错误
#### 列出实验
检索您组织的所有实验。
**端点：** `GET /experiments`
**查询参数：**
- `status` - 按状态过滤（可选）
- `limit` - 每页结果数（默认：50）
- `offset` - 分页偏移量（默认：0）
**响应：**
{
"experiments": [
{
"experiment_id": "exp_abc123xyz",
"status": "completed",
"experiment_type": "binding",
"created_at": "2025-11-24T10:00:00Z"
}
],
"total": 150,
"li
粤公网安备44030002003366号