From 29b31f1f2c07cfa3c332ba7ae5673049210ce537 Mon Sep 17 00:00:00 2001
From: Achilles <guoshuai@juyou88.com>
Date: Wed, 27 Dec 2023 12:36:03 +0800
Subject: [PATCH] =?UTF-8?q?bToday=E4=BB=A3=E7=A0=81=E6=8F=90=E4=BA=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../market/web/BTodayStockController.java     | 57 +++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/src/main/java/cn/stock/market/web/BTodayStockController.java b/src/main/java/cn/stock/market/web/BTodayStockController.java
index f99fdb8..7462282 100644
--- a/src/main/java/cn/stock/market/web/BTodayStockController.java
+++ b/src/main/java/cn/stock/market/web/BTodayStockController.java
@@ -4,6 +4,8 @@ import io.swagger.annotations.Api;
 import io.swagger.annotations.ApiImplicitParam;
 import io.swagger.annotations.ApiImplicitParams;
 import io.swagger.annotations.ApiOperation;
+import io.swagger.annotations.ApiResponse;
+import io.swagger.annotations.ApiResponses;
 import net.sf.json.JSONArray;
 import net.sf.json.JSONObject;
 import org.apache.commons.lang3.StringUtils;
@@ -73,6 +75,61 @@ public class BTodayStockController {
             @ApiImplicitParam(name="exchange",value = "BSE或者NSE"),
             @ApiImplicitParam(name="co_code",value = "coCode值"),
     })
+    @ApiResponses(value = {
+            @ApiResponse(code = 200, message = "这个接口返回的 JSON 字段说明如下：\n" +
+                    "status_code: 操作状态码，1 表示成功。\n" +
+                    "success: 操作是否成功，true 表示成功。\n" +
+                    "data: 包含具体数据的部分，是一个数组，包含了以下关于公司 \"Gujarat Fluorochemicals Ltd\" 的信息：\n" +
+                    "exchange: 交易所，这里是 NSE（国家股票交易所）。\n" +
+                    "sc_code: 股票代码。\n" +
+                    "symbol: 股票符号。\n" +
+                    "companyname: 公司全名，英文。\n" +
+                    "companyshortname: 公司简称，英文。\n" +
+                    "companyname_hi: 公司全名，印地文。\n" +
+                    "companyshortname_hi: 公司简称，印地文。\n" +
+                    "co_code: 公司代码。\n" +
+                    "mcap_val: 市值。\n" +
+                    "mcaptype: 市值类型，这里是 Mid Cap（中型市值）。\n" +
+                    "co_image: 公司图标的 URL。\n" +
+                    "sef_url: 公司的链接。\n" +
+                    "ros_sef_url: 公司 ROS 链接。\n" +
+                    "sectorname: 公司所属行业。\n" +
+                    "sc_group: 股票组别。\n" +
+                    "upd_time: 最后更新时间。\n" +
+                    "cmot_upd_time: CMOT 最后更新时间。\n" +
+                    "open_price: 开盘价。\n" +
+                    "high_price: 最高价。\n" +
+                    "cmot_high_price: CMOT 最高价。\n" +
+                    "price: 最新交易价。\n" +
+                    "cmot_price: CMOT 最新交易价。\n" +
+                    "low_price: 最低价。\n" +
+                    "cmot_low_price: CMOT 最低价。\n" +
+                    "bbuy_qty: 买入数量。\n" +
+                    "bbuy_price: 买入价格。\n" +
+                    "bsell_qty: 卖出数量。\n" +
+                    "bsell_price: 卖出价格。\n" +
+                    "perchg: 当前涨跌幅。\n" +
+                    "cmot_perchg: CMOT 涨跌幅。\n" +
+                    "pricediff: 当前价格变动。\n" +
+                    "cmot_pricediff: CMOT 价格变动。\n" +
+                    "vol_traded: 成交量。\n" +
+                    "cmot_vol_traded: CMOT 成交量。\n" +
+                    "val_traded: 成交额。\n" +
+                    "52weekhigh: 52周最高价。\n" +
+                    "52weeklow: 52周最低价。\n" +
+                    "value: 市值。\n" +
+                    "list_Info: 是否已上市。\n" +
+                    "h52date: 52周最高价日期。\n" +
+                    "l52date: 52周最低价日期。\n" +
+                    "b52high_adj: 调整后的 52周最高价。\n" +
+                    "b52low_adj: 调整后的 52周最低价。\n" +
+                    "isin: ISIN 编号。\n" +
+                    "prev_close: 前一交易日收盘价。\n" +
+                    "offerqty: 报价数量。\n" +
+                    "message: 返回信息，\"Successful\" 表示成功。\n" +
+                    "fromredis: 标志是否来自 Redis 缓存，false 表示不是", response = JSONObject.class),
+
+    })
     @GetMapping("/api/bToday/stockDetail")
     public com.alibaba.fastjson.JSONObject getPriceChartCompanyPullView(
             @RequestParam(value = "exchange") String exchange,