PWM CRM API 文档

快速开始

PWM CRM API 基于 RESTful 架构，所有请求使用 HTTPS 协议，数据格式为 JSON。基础 URL 为：

https://api.pwmapp.com/v1

第一步：获取 API Key

登录 PWM CRM 管理后台，进入「设置 - 开发者 - API 密钥」，点击「创建密钥」。系统会生成一对 API Key 和 API Secret，请妥善保存。

第二步：发起第一个请求

使用 curl 测试获取客户列表：

curl -X GET "https://api.pwmapp.com/v1/customers?page=1&page_size=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

成功响应示例：

{
  "code": 0,
  "message": "success",
  "data": {
    "total": 156,
    "page": 1,
    "page_size": 10,
    "items": [
      {
        "id": "cus_abc123",
        "name": "华东建材集团",
        "industry": "building_materials",
        "level": "A",
        "contact": "张经理",
        "phone": "138****8888",
        "created_at": "2026-01-15T10:30:00Z"
      }
    ]
  }
}

认证方式

PWM CRM API 支持两种认证方式：

1. API Key（推荐）

在请求头中携带 API Key：

Authorization: Bearer YOUR_API_KEY

2. OAuth 2.0

适用于第三方应用集成。流程：

1. 在开发者后台创建 OAuth 应用，获取 client_id 和 client_secret
2. 引导用户访问授权页：https://app.pwmapp.com/oauth/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&response_type=code
3. 用户授权后，获取 code，换取 access_token
4. 使用 access_token 调用 API

错误码

错误响应格式：

{
  "code": 10002,
  "message": "Invalid API Key",
  "request_id": "req_xyz789"
}

频率限制

超出限制时返回 429 状态码，响应头中包含 X-RateLimit-Reset 表示重置时间（Unix 时间戳）。

SDK 下载

我们提供多种语言的官方 SDK，简化集成过程：

• Python SDK：pip install pwmapp
• Node.js SDK：npm install @pwmapp/sdk
• Java SDK：Maven 依赖，详见 GitHub
• Go SDK：go get github.com/pwmapp/go-sdk
• PHP SDK：Composer 安装

SDK 源码和示例：https://github.com/pwmapp

接口参考

客户管理

创建客户请求示例：

POST /v1/customers
{
  "name": "恒瑞医药连锁",
  "industry": "pharmaceutical",
  "level": "A",
  "contact": "李主任",
  "phone": "13900001111",
  "email": "li@hengrui.com",
  "address": "上海市浦东新区张江路100号",
  "tags": ["重点客户", "医药"],
  "custom_fields": {
    "hospital_level": "三甲",
    "annual_budget": "5000000"
  }
}

商机管理

外勤拜访

跟进记录

数据报表

AI 能力

AI 对话请求示例：

POST /v1/ai/chat
{
  "query": "本月华东区的销售漏斗健康度如何？",
  "context": {
    "user_id": "usr_001",
    "page": "dashboard"
  },
  "stream": false
}

Webhook

Webhook 允许您在特定事件发生时接收实时通知。在「设置 - 开发者 - Webhook」中配置回调 URL 和订阅事件。

支持的事件类型：

• customer.created / customer.updated / customer.deleted
• opportunity.created / opportunity.stage_changed / opportunity.won / opportunity.lost
• visit.checkin / visit.checkout / visit.report_generated
• activity.created
• ai.alert.triggered（AI 异常预警）

Webhook 推送示例：

POST /your-webhook-endpoint
X-pwmapp-Signature: sha256=abc123...
{
  "event": "opportunity.won",
  "timestamp": "2026-08-29T10:30:00Z",
  "data": {
    "id": "opp_001",
    "name": "华东建材年度采购",
    "amount": 500000,
    "customer_id": "cus_001",
    "owner_id": "usr_001"
  }
}