API 概述
PandaTest API 接口文档
简介
PandaTest 提供 RESTful API,允许你通过编程方式管理设备、执行测试、获取报告。
基础信息
| 项目 | 值 |
|---|---|
| Base URL | https://api.pandatest.net/v1 |
| 认证方式 | Bearer Token |
| 响应格式 | JSON |
认证
所有 API 请求需要在 Header 中携带 API Key:
curl -X GET https://api.pandatest.net/v1/devices \
-H "Authorization: Bearer YOUR_API_KEY"获取 API Key
- 登录 PandaTest 控制台
- 进入「设置」→「API 密钥」
- 点击「生成新密钥」
⚠️
请妥善保管 API Key,不要在客户端代码中暴露。
响应格式
成功响应
{
"code": 0,
"message": "success",
"data": {
// 响应数据
}
}错误响应
{
"code": 40001,
"message": "Invalid API key",
"data": null
}错误码
| 错误码 | 说明 |
|---|---|
| 0 | 成功 |
| 40001 | 无效的 API Key |
| 40003 | 权限不足 |
| 40004 | 资源不存在 |
| 50000 | 服务器内部错误 |
API 列表
- 设备 API - 获取设备列表、连接设备、管理会话
- 测试 API - 创建测试任务、查询执行状态、获取报告
- 应用 API - 上传应用、管理应用版本
- 项目 API - 项目管理、成员管理
SDK
我们提供官方 SDK 简化 API 调用:
Python:
pip install pandatest-sdkfrom pandatest import PandaTest
client = PandaTest(api_key='YOUR_API_KEY')
devices = client.devices.list()JavaScript:
npm install @pandatest/sdkimport { PandaTest } from '@pandatest/sdk';
const client = new PandaTest({ apiKey: 'YOUR_API_KEY' });
const devices = await client.devices.list();速率限制
| 计划 | 请求限制 |
|---|---|
| 免费版 | 100 次/分钟 |
| 专业版 | 1000 次/分钟 |
| 企业版 | 无限制 |
超出限制会返回 429 Too Many Requests 错误。