dooray-sdk

README

Dooray! API in Go

This is the Dooray Client Library for Go.

This library is based on the Dooray! API Documentation.

Installing

go get

$ go get -u github.com/dooray-go/dooray-sdk

Features

Category	Feature	Method	Description
Socket Mode	Agent	NewAgent	Real-time event handling via WebSocket
Messenger	Webhook	PostWebhook	Send messages via webhook
	Direct Send	DirectSend	Send direct messages to users
	Send Message	SendMessage	Send messages to a channel
Project	Get Projects	GetProjects	Retrieve list of projects
	Get Posts	GetPosts	Retrieve posts from a project
	Get Posts (Options)	GetPostsWithOptions	Retrieve posts with full query parameters (paging, filters, date, sort)
	Create Post	CreatePost	Create a new post in a project
Calendar	Get Calendars	GetCalendars	Retrieve list of calendars
	Get Events	GetEvents	Retrieve events from calendars
	Create Event	CreateEvent	Create a new calendar event

Messenger WebHook Example

package main

import (
    "context"
    "github.com/dooray-go/dooray-sdk"
    "log"
    "time"
)

func main() {
    ctx1 := context.Background()
    subCtx1, _ := context.WithTimeout(ctx1, 3*time.Second)
    doorayErr := dooray.PostWebhookContext(subCtx1, "[Your WebHook URL]", &dooray.WebhookMessage{
        BotName: "dooray-go",
        Text:    "Hello",
    })
    
    if doorayErr != nil {
        log.Printf("dial error: %s", doorayErr.Error())
    }
}

OpenApi Examples

Get Posts from a Project

package main

import (
    "fmt"
    "log"

    "github.com/dooray-go/dooray-sdk/openapi/project"
)

func main() {
    projectClient := project.NewDefaultProject()
    projectID := "your-project-id"

    // Simple: filter by member IDs and workflow classes
    response, err := projectClient.GetPosts("your-dooray-api-key", projectID, "member-id-1,member-id-2", "registered,working")
    if err != nil {
        log.Fatalf("Failed to get posts: %s", err)
    }

    fmt.Printf("Total posts: %d\n", response.TotalCount)
    for _, post := range response.Result {
        fmt.Printf("Post #%d: %s\n", post.Number, post.Subject)
    }
}

Get Posts with Options

package main

import (
    "fmt"
    "log"

    "github.com/dooray-go/dooray-sdk/openapi/project"
)

func main() {
    projectClient := project.NewDefaultProject()
    projectID := "your-project-id"

    size := 10
    page := 0
    toMemberSize := 1

    response, err := projectClient.GetPostsWithOptions("your-dooray-api-key", projectID, project.GetPostsOptions{
        // Paging
        Page: &page,
        Size: &size,

        // Filters
        PostWorkflowClasses: "registered,working",
        ToMemberIds:         "member-id",
        ToMemberSize:        &toMemberSize,  // 1: toMemberIds[0]이 혼자 담당인 업무
        TagIds:              "tag-id-1,tag-id-2",
        MilestoneIds:        "milestone-id",

        // Date filters (today, thisweek, prev-{N}d, next-{N}d, or ISO8601 range)
        CreatedAt: "prev-7d",
        DueAt:     "next-30d",

        // Sort (prefix with - for descending)
        Order: "-createdAt",
    })
    if err != nil {
        log.Fatalf("Failed to get posts: %s", err)
    }

    fmt.Printf("Total posts: %d\n", response.TotalCount)
    for _, post := range response.Result {
        fmt.Printf("Post #%d: %s (status: %s)\n", post.Number, post.Subject, post.WorkflowClass)
    }
}

Create a Post in a Project

package main

import (
    "fmt"
    "log"
    "time"

    "github.com/dooray-go/dooray-sdk/openapi/project"
    model "github.com/dooray-go/dooray-sdk/openapi/model/project"
    "github.com/dooray-go/dooray-sdk/utils"
)

func main() {
    // Create a project client
    projectClient := project.NewDefaultProject()

    // Set due date (24 hours from now)
    dueDate := utils.JsonTime(time.Now().Add(24 * time.Hour))

    // Create a post request
    postRequest := model.PostRequest{
        Subject: "New Task",
        Body: model.PostBody{
            MimeType: "text/html",
            Content:  "<p>This is a new task created via API</p>",
        },
        Users: &model.PostUsers{
            To: []model.PostRecipient{
                {
                    Type: "member",
                    Member: &model.PostMember{
                        OrganizationMemberID: "member-id",
                    },
                },
            },
        },
        DueDate:  &dueDate,
        Priority: "normal", // urgent | high | normal | low
        TagIDs:   []string{"tag-id-1", "tag-id-2"},
    }

    // Create the post
    projectID := "your-project-id"
    response, err := projectClient.CreatePost("your-dooray-api-key", projectID, postRequest)
    if err != nil {
        log.Fatalf("Failed to create post: %s", err)
    }

    fmt.Printf("Post created successfully! ID: %s\n", response.Result.ID)
}