# api-core

**Repository Path**: xgh2012/api-core

## Basic Information

- **Project Name**: api-core
- **Description**: 核心代码仓库
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-09-18
- **Last Updated**: 2025-09-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# API Core

这是一个基于 Go 语言的 API 核心功能库，提供了多种工具函数和模块，用于简化开发流程和增强功能实现。

## 功能特性

- **加密解密**：支持身份证信息加密、AES 加密、HMAC-SHA256 等多种加密方式。
- **数据处理**：提供数组操作、字符串处理、结构体与 map 转换等功能。
- **数据库支持**：集成 MySQL 和 Redis 的连接与操作支持。
- **地理转换**：支持 BD09、GCJ02、WGS84 等坐标系统的相互转换。
- **日志记录**：使用 zap 实现高性能日志记录，并支持 GORM 日志集成。
- **网络请求**：封装了 HTTP GET 和 POST 请求方法。
- **验证工具**：提供手机号、身份证号等常用验证功能。
- **时间处理**：提供多种时间格式转换和处理函数。

## 安装

要使用此库，请确保你已经安装了 Go 环境。然后通过以下命令获取代码：

```bash
go get https://gitee.com/xgh2012/api-core
```

## 使用示例

### 加密身份证信息

```go
encoded, err := IdCardEncode("11010119XXXXXX2316")
if err != nil {
    // 处理错误
}
```

### 解密身份证信息

```go
decoded, err := IdCardDecode(encoded)
if err != nil {
    // 处理错误
}
```

### HMAC-SHA256 哈希计算

```go
hash := HashHmacSha256("key", "message")
```

### 数据库连接

```go
db, err := ConnectDatabase("username", "password", "localhost", "3306", "database", "utf8mb4")
if err != nil {
    // 处理错误
}
```

### Redis 初始化

```go
cfg := RedisConfig{Addr: "localhost:6379", Password: "", DB: 0}
client := InitRedis(cfg)
```

### 获取地理位置

```go
location, err := GetLocationByIp("8.8.8.8")
if err != nil {
    // 处理错误
}
```

## 贡献

欢迎贡献代码和提出建议。请在 Gitee 上提交 Pull Request。

## 许可证

本项目采用 MIT 许可证。详情请查看 LICENSE 文件。