# shop_data

**Repository Path**: ComicWechatMini/shop_data

## Basic Information

- **Project Name**: shop_data
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-14
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 添加店铺接口文档

## 接口描述
新增一个店铺信息。配送类型传入字符串（如“自配送”），由服务端转换为整型存储；状态默认为营业中（无需传入）；需提供参考地址及距离。成功创建后仅返回新店铺的 ID。

## 基本信息
- **请求 URL**：`POST /biz/openapi/shop/add`
- **请求方式**：`POST`
- **请求头**：`Content-Type: application/json`

## 请求参数
| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| shopName | String | 是 | 店铺名称 |
| monthlySales | Integer | 是 | 月售数量，≥0 |
| deliveryType | String | 是 | 配送类型，可选值：`自配送`、`其他类型`（前后空格自动忽略） |
| address | String | 是 | 店铺地址 |
| phone | String | 是 | 联系电话，7-15 位数字 |
| referenceAddress | String | 是 | 参考地址（如某个商圈中心） |
| distanceToReference | Integer | 是 | 商家地址距离参考地址的距离，单位：米，≥0 |

## 请求示例
```json
{
    "shopName": "老张牛肉面",
    "monthlySales": 1280,
    "deliveryType": "自配送",
    "address": "北京市朝阳区XX路XX号",
    "longitude": 116.397128,
    "latitude": 39.916527,
    "phone": "1851447",
    "referenceAddress": "北京市朝阳区XX商圈中心",
    "distanceToReference": 350
}
```

## 响应说明

### 成功响应示例
```json
{
    "code": 200,
    "msg": "操作成功",
    "data": {
        "id": 1001
    }
}
```

### 错误响应示例（配送类型不合法）
```json
{
  "code": 500,
  "msg": "未知的配送类型: 自行配送",
  "data": null
}
```

### 错误响应示例（参数校验失败）
```json
{
  "code": 500,
  "msg": "参考地址不能为空",
  "data": null
}
```