# t1y-sdk-go

**Repository Path**: t1ykf/t1y-sdk-go

## Basic Information

- **Project Name**: t1y-sdk-go
- **Description**: No description available
- **Primary Language**: Go
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-11-03
- **Last Updated**: 2024-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

T1 后端云 Go SDK 开发文档

本文档是 T1 后端云 官方提供的 Go SDK，方便 Go 开发人员快速使用 T1 进行后端开发。

# 准备工作

## SDK 下载

```shell
go get github.com/t1ykf/t1y-sdk-go
```

## 类库说明

- 初始化 SDK

```go
// 初始化 SDK 配置
client := t1y.Init("您的域名", 您的Application ID, "您的API Key", "您的Secret Key")
```

- 创建一条数据

```go
response, err := client.CreateOne("student", &Student{Name: "王华", Age: 21, Sex: "男"})
```

- 删除一条数据

```go
response, err := client.DeleteOne("student", "653f1f797ed5bb441885c00d")
```

- 更新一条数据

```go
response, err := client.UpdateOne("student", "653f1f797ed5bb441885c00d", map[string]interface{}{"$set": &Student{Name: "王华华", Age: 22, Sex: "女"}})
```

- 查询一条数据

```go
response, err := client.ReadOne("student", "653f1f797ed5bb441885c00d")
```

- 查询全部数据（分页查询）

```go
response, err := client.ReadAll("student", 1, 10)
```

## 运行效果

打开项目中的 `examples/main.go` 文件，可以看到如何使用 Go SDK 相关的方法。

```go
package main

import (
	"encoding/json"
	"log"

	"github.com/t1ykf/t1y-sdk-go"
)

// 表结构
type Student struct {
	Name string `json:"name"`
	Age  int    `json:"age"`
	Sex  string `json:"sex"`
}

// 响应
type Response struct {
	Code    int         `json:"code"`
	Message string      `json:"message"`
	Data    interface{} `json:"data"`
}

func main() {
	// 初始化 SDK 配置
	client := t1y.Init("http://dev.t1y.net/api", 1001, "2c6118c4e02b40fe96f5c40ee1dc5561", "650bd657da0243b282d9cab6d75a80ff")

	// 创建一条数据
	response, err := client.CreateOne("student", &Student{Name: "王华", Age: 21, Sex: "男"})
	// 删除一条数据
	//response, err := client.DeleteOne("student", "653f1f797ed5bb441885c00d")
	// 更新一条数据
	//response, err := client.UpdateOne("student", "653f1f797ed5bb441885c00d", map[string]interface{}{"$set": &Student{Name: "王华华", Age: 22, Sex: "女"}})
	// 查询一条数据
	//response, err := client.ReadOne("student", "653f1f797ed5bb441885c00d")
	// 查询全部数据（分页查询）
	//response, err := client.ReadAll("student", 1, 10)
	defer response.Body.Close()
	if err != nil {
		log.Printf("网络错误: %v", err)
		return
	}
	apiResponse := &Response{}
	if err := json.NewDecoder(response.Body).Decode(apiResponse); err != nil {
		log.Printf("解析JSON数据失败: %v", err)
		return
	}
	if apiResponse.Code != 200 {
		log.Printf("Code: %d", apiResponse.Code)
		log.Printf("Message: %s", apiResponse.Message)
		log.Printf("创建失败")
		return
	}
	log.Printf("Code: %d", apiResponse.Code)
	log.Printf("Message: %s", apiResponse.Message)
	dataBytes, _ := json.Marshal(apiResponse.Data)
	log.Printf("Data: %s", string(dataBytes))
	log.Printf("创建成功: %v", err)
}
```