# TAPD-PLUGIN-GO-SDK

# 简介

主要用于调用 TAPD api v2 接口的SDK

推荐版本: Go 1.12

# 安装

# 通过 go get 安装

go get git.woa.com/tapd-plugin-core/go-sdk

# 使用

# 申请应用

  1. 申请和使用应用 链接 (opens new window)

  2. 复制应用ID和密钥 https://o.tapd.woa.com/admin/{你的应用标识}/dashboard Alt

# DEMO

package main

import (
	tplugin "git.woa.com/tapd-plugin-core/go-sdk"
)

func main() {

	sdk := tplugin.NewSDK(
		"tapd", // 你的应用CODE
		"tapd", // 密钥 注意保密
		tplugin.WithAuthTypeOption(tplugin.Basic),  // 默认Basic,当传了accessToken时自动使用oauth方式
		tplugin.WithAddressOption("https://apiv2.tapd.woa.com"), // api服务地址,默认为内网线上环境
	)

	// 获取授权信息
	authorization, response := sdk.AuthorizationByCredentials()

	log.Printf("response:\n%#v", response)
	log.Printf("authorization:\n%#v", authorization)

	// 授权成功后 获取消息
	resp := sdk.GetStories(map[string]interface{}{
		"workspace_id": "755",
	})

	log.Printf("resp:\n%#v", resp)

	// 文件上传接口使用方式
	file, _ := ioutil.ReadFile("your file path")

	image := tplugin.File{
		Content: file,
		Name:    "your file name",
	}
	res := sdk.UploadImage(map[string]interface{}{
		"workspace_id": "755",
		"image":        image,
	})	

	log.Printf("resp:\n%#v", res)
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

# 查看所有SDK方法和参数 (opens new window)

# Artifact

https://git.woa.com/tapd-plugin-core/go-sdk/-/tags

# 常见问题

# IDC网络问题

使用SDK调用API无法响应,可查看自己是否处于IDC网络链接 (opens new window)

API地址如下:

  • 内网环境(默认): "http://apiv2.tapd.oa.com"
  • IDC环境: "http://oss.apiv2.tapd.woa.com"

IDC环境下的SDK设置:

package main

import (
	tplugin "git.woa.com/tapd-plugin-core/go-sdk"
)

func main() {

	sdk := tplugin.NewSDK(
		"tapd", // 你的应用CODE
		"tapd", // 密钥 注意保密
		tplugin.WithAuthTypeOption(tplugin.Basic),  // 默认Basic,当传了accessToken时自动使用oauth方式
		tplugin.WithAddressOption("http://oss.apiv2.tapd.woa.com"), // api服务地址,默认为内网线上环境
	)
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# Contributions

欢迎参与SDK共建!开发&共建流程,请参照 contributing.md (opens new window)

上次更新: 2025-04-16 17:40:50