# 【 创建挖宝记录】接口文档 v1.0.0
**所属平台**: PhalApi开源接口框架
**接口地址**: `https://cwf.ruffle.cn/?s=App.BillTreasure.Create`
**请求方式**: POST

## 接口基本信息
- **功能描述**:  创建一轮挖宝记录，支持同时记录收入和支出，包含总收入、总支出、总利润，同时记录明细
- **返回格式**: JSON

## 请求参数说明

### 系统参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| s | string | 必填 | 接口服务名，固定为`App.BillTreasure.Create` |


### 业务参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| openid | string | 必填 | 微信openid |
| record_date | string | 可选 | 记录日期 Y-m-d |
| goods_id | int | 可选 | 物品ID（单个物品模式） |
| goods_name | string | 可选 | 物品名称（单个物品模式） |
| price | float | 可选 | 单价（单个物品模式） |
| quantity | int | 可选 | 数量（单个物品模式） |
| type | int | 可选 | 类型 1=收入 2=支出（单个物品模式） |
| items | array | 可选 | 物品列表（数组模式，支持多个物品） |


## 返回字段
| 返回字段 | 类型 | 说明 |
|---|---|---|
| ret	| int | 接口状态码，`200`表示成功，`4xx`表示客户端非法请求，`5xx`表示服务端异常 |
| data | object/array/混合 | 接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。|
| msg | 字符串 | 提示信息，面向技术人员的帮助或错误提示信息，成功返回时为空字符串 |
| data.success | bool | 是否成功|
| data.bill_id | int | 挖宝记录ID|


## 请求示例
```bash
curl -X POST 'https://cwf.ruffle.cn/?s=App.BillTreasure.Create' \
  -H 'Content-Type: application/json' \
  -d '{"openid":"","record_date":"","goods_id":"","goods_name":"","price":"","quantity":1,"type":"","items":""}'
```

返回示例：
```json

```