Tapd

🚀 Go-Tapd-SDK

Go-Tapd-SDK 是一個用於訪問 Tapd API 的 Go 客戶端庫，藉助它可以方便地在 Go 項目裡與 Tapd 平臺進行交互。

⚠️ 重要提示

該版本目前尚不穩定，不建議在生產環境中使用。

💡 使用建議

如果你遇到任何問題，請隨時 提交問題。

🚀 快速開始

要使用 Go-Tapd-SDK，你可以按照以下步驟進行操作。

📦 安裝指南

使用以下命令安裝 Go-Tapd-SDK：

go get github.com/go-tapd/tapd

✨ 主要特性

見 features.md

💻 使用示例

基礎用法

API 服務

package main

import (
	"context"
	"log"

	"github.com/go-tapd/tapd"
)

func main() {
	client, err := tapd.NewClient("client_id", "client_secret")
	if err != nil {
		log.Fatal(err)
	}

	// 示例：獲取標籤
	labels, _, err := client.LabelService.GetLabels(context.Background(), &tapd.GetLabelsRequest{
		WorkspaceID: tapd.Ptr(123456),
	})
	if err != nil {
		log.Fatal(err)
	}

	log.Printf("labels: %+v", labels)
}

高級用法

Webhook 服務器示例

package main

import (
	"context"
	"log"
	"net/http"

	"github.com/go-tapd/tapd/webhook"
)

type StoreUpdateListener struct{}

func (l *StoreUpdateListener) OnStoryUpdate(ctx context.Context, event *webhook.StoryUpdateEvent) error {
	log.Printf("StoreUpdateListener: %+v", event)
	return nil
}

func main() {
	dispatcher := webhook.NewDispatcher(
		webhook.WithRegisters(&StoreUpdateListener{}),
	)
	dispatcher.Registers(&StoreUpdateListener{})

	srv := http.NewServeMux()
	srv.HandleFunc("/webhook", func(w http.ResponseWriter, r *http.Request) {
		log.Println("收到Webhook請求")
		if err := dispatcher.DispatchRequest(r); err != nil {
			log.Println(err)
		}
		w.Write([]byte("ok"))
	})

	http.ListenAndServe(":8080", srv)
}

📄 許可證

本項目採用 MIT 許可證（MIT）。更多內容請參見 LICENSE 文件。