update:docment and readme

Author: xengine-qyt

CHANGELOG

@@ -1,3 +1,25 @@
+XEngine_APIService V3.5.0.1001
+
+增加:机器信息收集增加服务名字段
+增加:机器信息报告查询
+增加:RFC的UDP服务端口的STUN协议代码支持
+增加:信息报告配置支持
+增加:NTP时间同步协议支持
+增加:油价查询支持
+修改:jsoncpp现在使用子模块方式加载
+修改:分离了版本信息从配置文件中
+修复:图像扩展名没有处理的问题
+
+added:rfc witch udp port and stun protocol supported
+added:query info for report
+added:service name for machine
+added:info report supported
+added:NTP time sync protocol supported
+added:oil price query supported
+modify:jsoncpp is depend sub module
+modify:detach version configure file
+fixed:image process ext name is incorrect
+======================================================================================
 XEngine_APIService V3.4.0.1001
 
 增加:lua脚本心跳协议支持

README.en.md

@@ -30,7 +30,7 @@ Support privatization deployment, free, safe, open source, controllable
 9. Zodiac Constellation
 10. Password generator
 11. World Time Zones
-12. Oil price inquiry (planned)
+12. Oil price inquiry
 13. Administrative zip code
 14. Bank card verification
 15. Exchange rate calculation (planned)
@@ -52,6 +52,8 @@ Support privatization deployment, free, safe, open source, controllable
 31. Region ID Convert
 32. Machine Information Collect
 33. heartbeat 
+34. STUN NAT Protocol 
+35. NTP Time Sync Protocol
 
 ## install
 
@@ -75,6 +77,11 @@ need to vcpkg configure third-part env.refer vcpkg install guide.after installed
 use vs open and compile,suport windows 7sp1 and above  
 Just Run it
 
+#### sub module
+Due to the dependent sub-modules, after you checkout the warehouse, execute the following command in the warehouse directory to pull the sub-modules  
+git submodule init  
+git submodule update  
+
 #### Linux
 ubuntu:sudo apt install sudo apt install liblua5.4-dev libopencv-dev libopencv-contrib-dev libqrencode-dev  
 centos:compile by self  
@@ -213,6 +220,25 @@ Api:http://app.xyry.org:5501/api?function=log&params1=1
     "nLogLevel":4
 }
 ```
+Oil Query  
+API:http://app.xyry.org:5501/api?function=oil&addr=四川  
+```json
+{
+    "code": 0,
+    "data": {
+        "dlValue0": 7.9100000000000001,
+        "dlValue10": 8.3800000000000008,
+        "dlValue20": 8.6899999999999995,
+        "dlValue35": 0,
+        "dlValue92": 8.2799999999999994,
+        "dlValue95": 8.8499999999999996,
+        "dlValue98": 9.6199999999999992,
+        "tszCityStr": "四川",
+        "tszUPTime": "2024-05-08 14:39:53"
+    },
+    "msg": "success"
+}
+```
 ## Participate in contribution
 I hope you will submit more code to participate in the contribution  
 

README.md

@@ -29,7 +29,7 @@ c c++ interface api service
 9. 生肖星座
 10. 密码生成器
 11. 世界时区
-12. 油价查询(计划中)
+12. 油价查询
 13. 行政邮编
 14. 银行卡验证
 15. 汇率计算(计划中)
@@ -51,6 +51,8 @@ c c++ interface api service
 31. 行政区域ID转换
 32. 机器信息收集
 33. 心跳处理
+34. STUN NAT协议
+35. NTP时间同步协议
 
 ## 安装教程
 
@@ -69,6 +71,11 @@ macos执行:./XEngine_LINEnv.sh -i 3
 需要MYSQL数据库8.0以上版本.通过CreateDatabase.sql创建表,然后导入剩余的表  
 修改配置文件里面XSQL里面的数据库配置为你的  
 
+#### sub module
+由于依赖的子模块,在你checkout仓库后,在仓库目录下执行下面的命令拉取子模块  
+git submodule init  
+git submodule update  
+
 #### Windows
 需要vcpkg配置第三方环境,具体参考vcpkg安装方式,安装好后执行:vcpkg.exe install lua:x86-windows opencv[contrib]:x86-windows libqrencode:x86-windows lua:x64-windows opencv[contrib]:x64-windows libqrencode:x64-windows  
 使用VS打开并且编译,支持WINDOWS 7SP1以上系统  
@@ -214,6 +221,25 @@ make FLAGS=CleanAll 清理编译
     "nLogLevel":4
 }
 ```
+油价查询  
+接口:http://app.xyry.org:5501/api?function=oil&addr=四川  
+```json
+{
+    "code": 0,
+    "data": {
+        "dlValue0": 7.9100000000000001,
+        "dlValue10": 8.3800000000000008,
+        "dlValue20": 8.6899999999999995,
+        "dlValue35": 0,
+        "dlValue92": 8.2799999999999994,
+        "dlValue95": 8.8499999999999996,
+        "dlValue98": 9.6199999999999992,
+        "tszCityStr": "四川",
+        "tszUPTime": "2024-05-08 14:39:53"
+    },
+    "msg": "success"
+}
+```
 ## 参与贡献
 希望大家多多提交代码参与贡献  
 

XEngine_Docment/Docment_en.docx

@@ -1,6 +1,6 @@
 {
     "XVer":[
-        "3.5.0.1001 Build20240508",
+        "3.5.0.1001 Build20240510",
         "3.4.0.1001 Build20240411",
         "3.3.0.1001 Build20240308",
         "3.2.0.1001 Build20231229",