客户

客户查询接口

根据关键字（支持客户的名称和编号的查询），得到与之匹配的客户。

curl -i "http://example.com/api/customers.json"

{
  "status": {
    "code": "200",
    "message": "OK"
  },
  "customers": [
    {
      "id": 1,
      "name": "Fluffums",
      "number": "C0001",
      "category": "重要客户",
      "enable": "启用"
    },
    {
      "id": 2,
      "name": "Max",
      "number": "C0002",
      "category": "普通客户",
      "enable" : "禁用"
    }
  ]
}

• HTTP 请求

  GET http://example.com/api/customers.json

• 请求参数

• 返回字段说明

客户详情

根据客户ID，获取客户详细信息。

curl -i "http://example.com/api/customers/2.json"

{
  "status": {
    "code": "200",
    "message": "OK"
  },
  "customer": {
    "id": 2,
    "name": "Max",
    "number": "C0002",
    "category": "普通客户",
    "enable": "禁用",
    "first payment": "20000",
    "current payment": "10000",
    "contacts" : [
      {
        "name": "张经理",
        "phone": "021-22839823",
        "mobile": "13928399382",
        "address": "上海市虹口区嘉兴路267号",
        "note": "客户经理",
        "is_primary" : true
      },
      {
        "name": "刘经理",
        "phone": "021-22839823",
        "mobile": "13928399382",
        "address": "上海市虹口区嘉兴路264号",
        "note": "渠道经理",
        "is_primary" : false
      }
    ]
  }
}

• HTTP 请求

  GET http://example.com/api/customers/:id.json

• 请求参数

• 返回字段说明

创建客户

curl -i -X POST "http://example.com/api/customers.json"

{
  "status": {
    "code": "200",
    "message": "OK"
  },
  "customer": {
    "id": 2,
    "name": "Max",
    "number": "C0002",
    "category": "普通客户",
    "enable": "禁用",
    "first payment": "20000",
    "current payment": "10000"
  }
}

• HTTP 请求

  POST http://example.com/api/customers/

• 请求参数

• 返回字段说明

编辑客户

curl -i -X PUT "http://example.com/api/customers/ID.json"

{
  "status": {
    "code": "200",
    "message": "OK"
  },
  "customer": {
    "id": 2,
    "name": "Max",
    "number": "C0002",
    "category": "普通客户",
    "assignee_name": "超管",
    "pre_collect_amount": "20000",
    "actual_collect_amount": "10000"
  }
}

• HTTP 请求

  PUT http://example.com/api/customers/ID.json

• 请求参数

• 返回字段说明