供应商

供应商查询接口

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

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

请求返回JSON数据：

{
  "status": {
    "code": "200",
    "message": "OK"
  },
  "suppliers": [
    {
      "id": 1,
      "name": "Fluffums",
      "number": "S0001",
      "category": "经销商",
      "balance": 1000.0
    },
    {
      "id": 2,
      "name": "Max",
      "number": "S0002",
      "category": "代理商",
      "balance": 0.0
    }
  ]
}

• HTTP 请求

  GET http://example.com/api/suppliers/query.json

• 请求参数

• 返回字段说明

供应商详情

根据供应商ID，获取供应商详细信息。

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

{
  "status": {
    "code": "200",
    "message": "OK"
  },
  "supplier": {
    "id": 1,
    "name": "Fluffums",
    "number": "S0001",
    "category": "经销商",
    "default_amount": 500.0,
    "balance": 1000.0,
    "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/suppliers/:id.json

• 请求参数

• 返回字段说明

创建供应商

根据提供的数据，创建供应商。

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

{
  "id": 1,
  "name": "Fluffums",
  "number": "S0001",
  "category": "经销商",
  "default_amount": 500.0,
  "balance": 1000.0
}

• HTTP 请求

  POST http://example.com/api/suppliers.json

• 请求参数

• 返回字段说明

编辑供应商

根据提供的数据，创建供应商。

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

{
  "id": 1,
  "name": "Fluffums",
  "number": "S0001",
  "category": "经销商",
  "default_amount": 500.0,
  "balance": 1000.0
}

• HTTP 请求

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

• 请求参数

• 返回字段说明