REST API v1

REST API 文档

自动化您的电池护照工作流程。通过 REST API 创建、更新、发布和导出产品。

身份验证

需要 Scale 方案。请在您的组织设置中生成密钥。

Authorization: Bearer dpp_live_...

Base URL

每个组织每分钟 120 个请求。

https://app.dpphero.com/api/v1

Quick Example

curl -X POST https://app.dpphero.com/api/v1/products \
  -H "Authorization: Bearer dpp_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "LFP Module 48V",
    "serial_number": "BAT-2025-001",
    "battery_category": "industrial",
    "manufacturing_date": "2025-06-15",
    "battery_mass": 45.5
  }'

可用端点

所有端点需要 Bearer token（API 密钥）。在 Scale 方案中可用。

产品

GET/products列出产品

POST/products创建产品

GET/products/{id}获取产品

PATCH/products/{id}更新产品

DELETE/products/{id}删除产品

POST/products/{id}/image上传产品图片

DELETE/products/{id}/image删除产品图片

POST/products/{id}/files上传文档/文件

电池状态

通过 API 更新动态 BMS 数据，如充电状态、循环次数和容量衰减。

GET/products/{id}/condition读取电池状态

PATCH/products/{id}/condition创建或更新电池状态

批量导入

POST/products/bulk批量创建产品

导出

GET/products/{id}/export/json导出 DIN SPEC 99100 JSON

GET/products/{id}/export/pdf导出电池护照 PDF

GET/products/{id}/export/qr导出 QR 码

组织

GET/organization获取组织信息

GET/facilities列出生产设施

GET/audit-log查询操作日志

完整文档

包含字段定义、示例负载、错误码、自动填充规则和 DIN SPEC 99100 产品 Schema 的完整 API 参考可在您的控制面板中获取。

查看方案登录以访问文档