api

Documentation

Index

• func HandleErrorResponse(resp *http.Response) error
• type APIError
  • func (e *APIError) Error() string
• type AuthExpiredError
  • func (e *AuthExpiredError) Error() string
• type Client
  • func NewClient(token string) *Client
  • func (c *Client) DoRequest(req *http.Request) (*http.Response, error)
  • func (c *Client) Token() string
• type RateLimiter
  • func NewRateLimiter() *RateLimiter
  • func (rl *RateLimiter) ShouldRetry(resp *http.Response) bool
  • func (rl *RateLimiter) Update(resp *http.Response)
  • func (rl *RateLimiter) Wait()

Functions

func HandleErrorResponse

func HandleErrorResponse(resp *http.Response) error

HandleErrorResponse checks an HTTP response for errors and returns a user-friendly error.

Types

type APIError

type APIError struct {
	StatusCode int
	Message    string
	Err        string
}

APIError represents an error returned by the ClickUp API.

func (*APIError) Error

func (e *APIError) Error() string

type AuthExpiredError

type AuthExpiredError struct {
	Detail string
}

AuthExpiredError indicates the API token is invalid, expired, or revoked. Detail preserves the original API response body for debugging.

func (*AuthExpiredError) Error

func (e *AuthExpiredError) Error() string

type Client

type Client struct {
	Clickup     *clickup.Client
	HTTPClient  *http.Client
	RateLimiter *RateLimiter
	// contains filtered or unexported fields
}

Client wraps the go-clickup client with auth and rate limiting.

func NewClient

func NewClient(token string) *Client

NewClient creates a new API client with the given token.

func (*Client) DoRequest

func (c *Client) DoRequest(req *http.Request) (*http.Response, error)

DoRequest makes a raw HTTP request to the ClickUp API.

func (*Client) Token

func (c *Client) Token() string

Token returns the API token used by this client.

type RateLimiter

type RateLimiter struct {
	// contains filtered or unexported fields
}

RateLimiter tracks ClickUp API rate limits and provides backoff.

func NewRateLimiter

func NewRateLimiter() *RateLimiter

NewRateLimiter creates a new rate limiter.

func (*RateLimiter) ShouldRetry

func (rl *RateLimiter) ShouldRetry(resp *http.Response) bool

ShouldRetry returns true if the response indicates rate limiting and the request should be retried.

func (*RateLimiter) Update

func (rl *RateLimiter) Update(resp *http.Response)

Update reads rate limit headers from a response.

func (*RateLimiter) Wait

func (rl *RateLimiter) Wait()

Wait blocks until it's safe to make another request.