https://github.com/nulab/go-typetalk

go-typetalk is a GO client library for accessing the Typetalk API.
https://github.com/nulab/go-typetalk

api-client golang typetalk

Last synced: 2 days ago
JSON representation

go-typetalk is a GO client library for accessing the Typetalk API.

• Host: GitHub
• URL: https://github.com/nulab/go-typetalk
• Owner: nulab
• License: mit
• Created: 2017-03-10T10:38:47.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2021-01-25T02:46:39.000Z (almost 4 years ago)
• Last Synced: 2024-08-03T11:08:54.676Z (3 months ago)
• Topics: api-client, golang, typetalk
• Language: Go
• Homepage: http://developer.nulab-inc.com/docs/typetalk
• Size: 226 KB
• Stars: 20
• Watchers: 48
• Forks: 7
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
go-typetalk

=========

[![Build Status](https://travis-ci.com/nulab/go-typetalk.svg?branch=master)][travis]

[![Coverage Status](https://coveralls.io/repos/github/nulab/go-typetalk/badge.svg?branch=master)][coveralls]

[![Documentation](https://godoc.org/github.com/nulab/go-typetalk?status.svg)][godocs]

[travis]: https://travis-ci.com/nulab/go-typetalk

[coveralls]: https://coveralls.io/github/nulab/go-typetalk?branch=master

[godocs]: http://godoc.org/github.com/nulab/go-typetalk

go-typetalk is a GO client library for accessing the [Typetalk API](https://developer.nulab.com/docs/typetalk).

## Prerequisite

To use this library, you must have a valid [client id and client secret](https://developer.nulab.com/docs/typetalk/auth#oauth2) provided by Typetalk and register a new client application. Or you can use the [Typetalk Token](https://developer.nulab.com/docs/typetalk/auth#tttoken).

## Usage

### Import

Use v1:

``` go

import "github.com/nulab/go-typetalk/v3/typetalk/v1" // with go modules enabled (GO111MODULE=on or outside GOPATH)

import "github.com/nulab/go-typetalk/typetalk/v1" // with go modules disabled

```

Use v2:

``` go

import "github.com/nulab/go-typetalk/v3/typetalk/v2" // with go modules enabled (GO111MODULE=on or outside GOPATH)

import "github.com/nulab/go-typetalk/typetalk/v2" // with go modules disabled

```

Use v3:

``` go

import "github.com/nulab/go-typetalk/v3/typetalk/v3" // with go modules enabled (GO111MODULE=on or outside GOPATH)

import "github.com/nulab/go-typetalk/typetalk/v3" // with go modules disabled

```

### Access APIs using Typetalk Token

``` go

package main

import (

	"context"

	v1 "github.com/nulab/go-typetalk/typetalk/v1"

)

func main() {

	client := v1.NewClient(nil)

	client.SetTypetalkToken("yourTypetalkToken")

	ctx := context.Background()

	topicID := 1

	message := "Hello"

	profile, resp, err := client.Messages.PostMessage(ctx, topicId, message, nil)

}

```

### Access APIs using OAuth2 Access Token

``` go

package main

import (

	"context"

	"encoding/json"

	"net/http"

	"net/url"

	v1 "github.com/nulab/go-typetalk/typetalk/v1"

	"golang.org/x/oauth2"

)

type AccessToken struct {

	AccessToken  string `json:"access_token"`

	TokenType    string `json:"token_type"`

	ExpiresIn    int    `json:"expires_in"`

	RefreshToken string `json:"refresh_token"`

}

func main() {

	form := url.Values{}

	form.Add("client_id", "yourClientId")

	form.Add("client_secret", "yourClientSecret")

	form.Add("grant_type", "client_credentials")

	form.Add("scope", "topic.read,topic.post,topic.write,topic.delete,my")

	oauth2resp, err := http.PostForm("https://typetalk.com/oauth2/access_token", form)

	if err != nil {

		print("Client Credential request returned error")

	}

	v := &AccessToken{}

	json.NewDecoder(oauth2resp.Body).Decode(v)

	tc := oauth2.NewClient(context.Background(), oauth2.StaticTokenSource(

		&oauth2.Token{AccessToken: v.AccessToken},

	))

	client := v1.NewClient(tc)

	profile, resp, err := client.Accounts.GetMyProfile(context.Background())

}

```

## Bugs and Feedback

For bugs, questions and discussions please use the Github Issues.