# BuyOneGoods
**GOODS_STATUS**
```
GOODS_STATUS_ON_SALE = 1 //开启
GOODS_STATUS_SHELVES_DOWN = 2 //关闭
GOODS_STATUS_AUDIT = 3 //待审批（默认）
```
|字段名称|值 |描述 |
|---|---|---|
|id |`数字`| ID |
|goods_id|`1`|商品ID|
|producer_id | `3` | 商户ID |
|producer_name | `牛肉面的店子` | 商户名称|
|name|`意大利牛肉面`|商品名称|
|image|`[{PHOTO},{PHOTO}]`|商品图片|
|desc|`描述`|描述|
|goods_max_num|`100` | 商品原总数量 |
|goods_num|`100` | 商品剩余数量 |
|original_price|`60`|商品原价|
|price|`25.5`|商品价格|
|status|`<GOODS_STATUS>`|商品状态|
|started_at | 2015-11-22 13:00:00 | 商品开放时间 |
|created_at | | 创建时间 |
|updated_at | | 更新时间 |
|deleted_at | | 删除时间 |
- 简介
- Header头简介
- 错误体简介
- 通用JSON格式简介
- 可分页接口的URL简介
- 返回状态码简介
- 推送 pusher
- 百度地理位置信息
- 文档规范
- 模型列表
- 用户相关模型
- 用户模型 User
- 用户扩展模型 UserExtend
- 用户统计 UserStats
- 通讯录模型 ContactList
- 商家相关模型
- 商家模型 Producer
- 商家扩展模型 ProducerExtend
- 服务类别模型 ServiceCategorys
- 商品模型 Goods
- 附近商家模型 NearbyProducer
- 商家统计模型 ProducerStats
- 任务相关模型
- 任务模型 Task
- 订单模型 Order
- 点评 Evaluation
- 附近任务模型 NearbyTask
- 热门任务 HotTask
- 特殊模型
- 地理位置模型 GEO
- 版本模型 Version
- 喜欢任务模型 LikeTask
- 喜欢人模型 LikeUser
- 喜欢商品模型 LikeGoods
- 收藏模型 Collect
- 统计相关模型
- 微信和支付宝请求记录
- 钱包相关模型
- 钱包 Wallet
- 钱包问题 WalletQuestion
- 钱包问题答案 WalletAnswer
- 钱包交易记录 WalletTradeRecord
- 钱包交易记录明细
- 提现账户：WithdrawAccount
- 广告相关模型
- 搜索相关模型
- 优惠券模型：Coupon
- 投诉模型：Complaint
- 纠纷模型：Dispute
- 服务菜单模型：ServiceMenu
- 活动相关模型
- 买一赠一活动
- 参加活动商品表 BuyOneGoods
- 活动用户统计表 BuyOneUserStats
- 活动商户统计表 BuyOneProducerStats
- 用户版API
- 认证API
- 用户认证 POST /authorizations
- 用户API
- 获取指定用户 GET /users/{user_id}
- 注册用户 POST /users
- 更新 PATCH /users/{user_id}
- 验证密码 GET /user/password?password={password}
- 重置密码 PATCH /user/password
- 检测手机号码是以被注册 GET /user/check-cellphone/{cellphone}
- [停用] 黑名单API 转移到用户关系中
- 获取黑名单列表 GET /blacklist
- 获取指定用户黑名单状态 GET /user-blacklist/{user_id}
- 添加黑名单 POST /user-blacklist
- 取消黑名单 DELETE /user-blacklist/{user_id}
- 通讯录API
- 拉取通讯录 GET /contact-list?uuid={?uuid}
- 通讯录上传 POST /contact-list
- 编辑通讯录 PATCH /contact-list/{user_id}
- 删除指定联系人 DELETE /contact-list/{user_id}?cellphone={cellphone}
- 用户关系操作API
- 获取关系列表 GET /relations
- 添加用户关系 POST /relations
- 删除用户关系 DELETE /relations/{user_id}
- 热门任务API
- 拉取热门任务 GET /hot-task
- 任务API
- 获取任务列表 GET /tasks
- 任务详情 GET /tasks/{id}
- 发布任务 POST /tasks
- 永久隐藏任务 PATCH /tasks/{id}/hidden
- 结活 PATCH tasks/{id}/complete
- 强制进入抢单模式 PATCH /tasks/{id}/capture
- 删除任务 DELETE /tasks/{id}
- 订单API
- 获取订单列表 GET /orders
- 获取订单详情 GET /orders/{id}
- 接取任务 POST /orders
- 修改订单信息 PATCH /orders/{id}
- 提交议价接口 PATCH /orders/{id}/bargain
- 交活 PATCH /orders/{id}/apply
- 取消(退出)任务 DELETE /orders/{id}
- 点评API
- 拉取点评列表 GET /evaluation
- 评价和回评 POST /evaluation
- 广告API
- 获取广告列表 GET /ads
- 隐藏广告 PATCH /ads/{id}/hidden
- 搜索API
- 搜索：GET /searchs
- 钱包API
- 获取指定钱包的钱包信息：POST /wallets/{user_id}
- 申请提现：POST /wallets/{wallet_id}/withdraw
- 获取钱包交易记录：GET /wallets/{wallet_id}/trades
- 钱包问题API
- 获取钱包问题列表：GET /wallet-questions
- 获取需要验证回答的问题：GET /wallet-questions/{wallet_id}
- 验证钱包问题答案 POST /wallet-question-answers/check
- 钱包密码API
- 设置钱包密码：POST /wallet-passwords/set
- 更改钱包密码：PATCH /wallet-passwords/{wallet_id}
- 检查钱包密码：POST /wallet-passwords/check
- 提现账户API
- 获取指定钱包的提现账户：GET /withdraw-accounts
- 添加提现账户：POST /withdraw-accounts
- 删除提现账户：DELETE /withdraw-accounts/{id}
- 收藏API
- 收藏列表 GET /collect
- 加入收藏 POST /collect
- 取消收藏 DELETE /collect
- 喜欢商品 API
- 获取喜欢的商品列表 GET /like/goods
- 添加商品喜欢 POST /like/goods
- 取消商品喜欢 DELETE /like/goods/{goods_id}
- 喜欢任务 API
- 获取喜欢任务列表 get /like/task
- 添加喜欢任务 POST /like/task
- 取消喜欢 DELETE /like/task
- 喜欢某人 API
- 获取喜欢的人列表 GET /like/user
- 对某人添加喜欢 POST /like/user
- 取消喜欢某人 DELETE /like/user/{user_id}
- Geo相关API
- 优惠券API
- 获取指定钱包的优惠券：GET /coupons
- 添加优惠券：POST /coupons
- 文件上传下载API
- 文件上传 POST /files
- 音频下载 GET /download/audio/{id}
- 支付API
- 支付任务：POST /paytask
- 快活钱包充值：POST /paywallet
- 支付任务同步处理：POST /syncnotifytask
- 钱包充值同步处理：POST /syncnotifywallet
- 投诉API
- 发起投诉 POST /complaints
- 申请纠纷API
- 发起纠纷 POST /disputes
- 意见反馈API
- 提交意见 POST /suggests
- 版本检测API
- 使用平台来查询最新版本 GET /version/{platform}
- 短信API
- 发送短信 POST / identity-code?action={$action}
- 验证短信 GET /identity-code/{code}
- 服务菜单API
- 获取服务菜单列表：GET /service_menus
- 商户版API
- 商户管理API
- 签约商户 POST /producer
- 修改我的商户信息 PATCH /producer/{id}
- 获取我的商户信息 GET /producer
- 提交认证 POST /producer-authorization
- 获取最后认证的信息 GET /producer-authorization
- 附近商家 API
- 附近商家 GET /nearby-producer?arc={arc}
- 商户商品管理API
- 获取商品列表 GET /goods?type={type}
- 添加商品 POST /goods
- 修改商品 PATCH /goods/{goods_id}
- 删除商品 DELETE /goods/{goods_id}
- 商户商品列表 /producer/{producer_id}/goods?type={?type}
- 商户任务API
- 任务详情 GET /business/tasks/{id}
- 商户订单API
- 商户订单列表 GET /business/orders
- 接取任务 POST /business/orders
- 交活 PATCH /business/orders/{id}/delivery
- 议价 PATCH /business/orders/{id}/bargain
- 商家评价API
- 拉取商家评价列表 GET /business/evaluation
- 商户钱包API
- 获取指定钱包的钱包信息：POST /business/wallets/{user_id}
- 获取钱包交易记录：GET /business/wallets/{wallet_id}/trades
- 商户钱包问题API
- 获取需要验证回答的问题：GET /business/wallet-questions/{wallet_id}
- 验证钱包问题答案 POST /business/wallet-question-answers/check
- 商户钱包密码API
- 设置钱包密码：POST /business/wallet-passwords/set
- 更改钱包密码：PATCH /business/wallet-passwords/{wallet_id}
- 检查钱包密码：POST /business/wallet-passwords/check
- 商家提现账户API
- 获取指定钱包的提现账户：GET /business/withdraw-accounts
- 添加提现账户：POST /business/withdraw-accounts
- 将指定类型的提现账号设为默认：PATCH /business/withdraw-accounts/{withdraw-account_id}/default
- 删除提现账户：DELETE /business/withdraw-accounts/{id}
- 商户统计API
- 拉取报表
- 系统调用API
- 活动相关API
- 分享统计：POST /shares
- 商家相关 API
- 商家审核 POST /system/api/approve-producer
- 商家禁用 POST /system/api/disable-producer
- 发送短信API
- 后台发送任务API
- 后台支付任务API
- 更新记录
- 版本 1.6.4
- JS互调文档
- 公共信息
- 分享调用
- 是否登录
- 创建任务
- 点赞商品
- 跳转商家详情