API 参考
概述

API 概述

PandaTest API 接口文档

简介

PandaTest 提供 RESTful API,允许你通过编程方式管理设备、执行测试、获取报告。

基础信息

项目
Base URLhttps://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

  1. 登录 PandaTest 控制台
  2. 进入「设置」→「API 密钥」
  3. 点击「生成新密钥」
⚠️

请妥善保管 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-sdk
from pandatest import PandaTest
 
client = PandaTest(api_key='YOUR_API_KEY')
devices = client.devices.list()

JavaScript:

npm install @pandatest/sdk
import { PandaTest } from '@pandatest/sdk';
 
const client = new PandaTest({ apiKey: 'YOUR_API_KEY' });
const devices = await client.devices.list();

速率限制

计划请求限制
免费版100 次/分钟
专业版1000 次/分钟
企业版无限制

超出限制会返回 429 Too Many Requests 错误。