README.md

XEngine_APIService

本仓库有开发和主分支,如果要使用,请使用master分支下的代码
只要仓库不是在暂停状态,那么就会有人一直维护和开发,请放心使用

介绍

c c++ 接口服务器
c c++ interface api service
这是一个信息查询的API接口服务,目前市面上的信息查询服务都需要收费,而我们这个信息查询服务属于免费开源的.
这个服务主要使用HTTP/V1.1实现各种接口服务.
这是一个不包含任何语言属性的通用信息查询服务.
你可以使用此代码实现自己的信息查询服务,支持查询任何信息
基于libXEngine开发并实现的一套简洁高性能跨平台接口服务
并且支持插件系统,dll(so,dylib)模块或者lua脚本

为什么选择我们

支持私有化部署,免费,安全.开源,可控

软件特性

权限验证
支持IP地址位置信息查询
支持身份证校验与信息查询
支持手机号信息归属查询
天气预报(计划中)
农历公历转换(计划中)
新闻头条(计划中)
标准身高体重
生肖星座
密码生成器
世界时区
油价查询(计划中)
行政邮编
银行卡验证
汇率计算(计划中)
二维码生成解析
简繁转换
二十四节气(计划中)
新华词典
计量转换
网络测试
分布式锁API
短连接生成和转发
本地标准时间
数学计算
日志服务
插件脚本热重载
敏感词检测

安装教程

XEngine环境

必须安装XEngine,版本需要V8.x或者以上版本,安装XEngine可以参考其Readme文档
GITEE:https://gitee.com/xyry/libxengine
GITHUB:https://github.com/libxengine/xengine

快速部署

git clone https://gitee.com/xyry/libxengine.git 或者 git clone https://github.com/libxengine/xengine.git
window执行XEngine_WINEnv.bat 脚本.
Linux执行:sudo ./XEngine_LINEnv.sh -i 3
macos执行:./XEngine_LINEnv.sh -i 3

数据库环境

需要MYSQL数据库8.0以上版本.通过CreateDatabase.sql创建表,然后导入剩余的表
修改配置文件里面XSQL里面的数据库配置为你的

Windows

需要vcpkg配置第三方环境,具体参考vcpkg安装方式,安装好后执行:vcpkg.exe install lua lua:x64-windows opencc opencc:x64-windows opencv[contrib] libqrencode opencv[contrib]:x64-windows libqrencode:x64-windows
使用VS打开并且编译,支持WINDOWS 7SP1以上系统
直接运行即可

Linux

ubuntu:sudo apt install liblua5.3-dev libopencc-dev libopencv-dev libopencv-contrib-dev libqrencode-dev
centos:需要自己编译
Linux使用Makefile编译,UBUNTU22.04 x64或者RockyLinux 9 x64 在控制台运行

Macos

安装opencc,执行命令:brew install lua opencc
使用makefile编译,控制台运行,需要mac 13以及以上版本
在控制台运行

编译命令

在XEngine_Source目录下执行命令
make 编译
make FLAGS=InstallAll 安装库程序
make FLAGS=CleanAll 清理编译

插件使用

你可以参考XEngine_PluginModule 下面的项目来编写插件
编写好的插件需要通过JSON配置才能启用

使用说明

切换到MASTER分支
下载代码
编译
安装
运行

目录结构

XEngine_Docment 文档目录结构
XEngine_Release 安装目录结构
XEngine_Source 源代目录结构
XEngine_APPClient 客户端演示代码

当前任务

其他问题

你可以参考docment目录下的文档.里面包含了API协议和服务说明.

测试服务器

地址:app.xyry.org,端口:5501

测试接口示例

更多内容请参考文档
身份证查询
接口:http://app.xyry.org:5501/api?function=id&params1=511025198800000000

{
    "code":0,
    "data":{
        "nBirthDay":00,
        "nBirthMonth":00,
        "nBirthYear":1988,
        "nCheck":2,
        "nPoliceID":87,
        "nSex":1,
        "tszCity":"内江市",
        "tszCounty":"资中县",
        "tszIDNumber":"511025198800000000",
        "tszProvincer":"四川省"
    },
    "msg":"success"
}

银行卡验证
接口:http://app.xyry.org:5501/api?function=bank&params1=6214832830000000

{
    "code":0,
    "data":{
        "enBankType":2,
        "tszBankAbridge":"CMB",
        "tszBankName":"招商银行",
        "tszBankNumber":"6214832830000000"
    },
    "msg":"success"
}

语言转换
接口:http://app.xyry.org:5501/api?function=language&params1=简体到繁体&params2=1

{
    "code":0,
    "data":{
        "enType":1,
        "tszDestStr":"簡體到繁體",
        "tszSourceStr":"简体到繁体"
    },
    "msg":"success"
}

翻译
接口:http://app.xyry.org:5501/api?function=translation&params1=中国&params2=0

{
    "code":0,
    "data":{
        "enType":0,
        "tszDestStr":"China",
        "tszSourceStr":"中国"
    },
    "msg":"success"
}

分布式锁
接口:http://app.xyry.org:5501/api?function=lock&params1=1000154321&params2=1

{
    "code":0,
    "data":{
        "xhToken":1000154321
    },
    "msg":"success"
}

行政邮编
接口:http://app.xyry.org:5501/api?function=zipcode&params1=0

{
    "nZipCode":100010
}

日志操作
接口:http://app.xyry.org:5501/api?function=log&params1=1

{
    "tszTableName":"xengine",
    "tszLogBuffer":"d12d",
    "nLogSize":4,
    "tszFileName":"file.cpp",
    "tszFuncName":"xengine_file_insert",
    "tszLogTimer":"2023-01-13 22:10:01",
    "nLogLine":102,
    "nLogLevel":4
}

参与贡献

希望大家多多提交代码参与贡献

Fork 本仓库
新建 Feat_xxx 分支
提交代码
新建 Pull Request

关注我们

如果你觉得这个软件对你有帮助,请你给我们一个START吧

提交问题

如果你有问题或者发现程序有BUG和意见,可以在issues中提交

项目简介

c c++ 信息查询服务 c c++ information query service

发行版本

当前项目没有发行版本

贡献者 1

xengine-qyt @aaadddzxc

开发语言

C++ 83.5 %
C 12.1 %
Makefile 3.4 %
Batchfile 0.7 %
Lua 0.3 %

XEngine / XEngine APIService 8 个月 前同步成功