See Go SDK

Official Golang SDK for S.EE URL shortener service. Create, manage, and track short URLs with ease.

Features

• 🔗 Create short URLs with custom slugs
• 🔒 Password-protected links
• ⏰ Expiration time support
• 🏷️ Tag management for organization
• 🌐 Multiple domain support
• 📊 Track and analyze link performance

Installation

go get github.com/sdotee/sdk.go

Quick Start

Initialize the client with your API credentials:

import seesdk "github.com/sdotee/sdk.go"

client := seesdk.NewClient(seesdk.Config{
    BaseURL: "https://api.s.ee",
    APIKey:  "your-api-key-here",
})

Create your first short URL:

resp, err := client.CreateShortURL(seesdk.CreateShortURLRequest{
    TargetURL: "https://www.example.com/very/long/url",
    Domain:    "s.ee",
    Title:     "My Link",
})

fmt.Printf("Short URL: %s\n", resp.Data.ShortURL)

Usage Examples

Domain and Tag Management

// Get available domains
domains, _ := client.GetDomains()
fmt.Println(domains.Data.Domains)

// Get available tags
tags, _ := client.GetTags()
for _, tag := range tags.Data.Tags {
    fmt.Printf("%s (ID: %d)\n", tag.Name, tag.Id)
}

Advanced Short URL Creation

Create a custom branded link with expiration and password protection:

expireAt := time.Now().Add(30 * 24 * time.Hour).Unix()

resp, err := client.CreateShortURL(seesdk.CreateShortURLRequest{
    TargetURL:  "https://www.example.com/campaign",
    Domain:     "s.ee",
    CustomSlug: "summer-sale",
    ExpireAt:   expireAt,
    Password:   "secret123",
    Title:      "Summer Sale Campaign",
    TagIDs:     []int64{1, 2},
})

Update and Delete

// Update existing short URL
client.UpdateShortURL(seesdk.UpdateShortURLRequest{
    Domain:    "s.ee",
    Slug:      "summer-sale",
    TargetUrl: "https://www.example.com/new-campaign",
    Title:     "Updated Campaign",
})

// Delete short URL
client.DeleteShortURL(seesdk.DeleteURLRequest{
    Domain: "s.ee",
    Slug:   "summer-sale",
})

API Reference

Client Configuration

Field	Type	Required	Description
BaseURL	string	Yes	API endpoint URL
APIKey	string	Yes	Your authentication token
Timeout	time.Duration	No	Request timeout (default: 30s)

Methods

CreateShortURL(req CreateShortURLRequest) - Create a new short URL

UpdateShortURL(req UpdateShortURLRequest) - Modify an existing short URL

DeleteShortURL(req DeleteURLRequest) - Remove a short URL

GetDomains() - List available domains

GetTags() - List available tags

Request Models

CreateShortURLRequest

Field	Type	Required	Description
TargetURL	string	Yes	Destination URL
Domain	string	Yes	Short domain name
CustomSlug	string	No	Custom URL slug
ExpireAt	int64	No	Unix timestamp (seconds)
Password	string	No	Access password
TagIDs	[]int64	No	Associated tag IDs
Title	string	No	Link description
ExpirationRedirectURL	string	No	Redirect after expiration

UpdateShortURLRequest

Field	Type	Required
Domain	string	Yes
Slug	string	Yes
TargetUrl	string	Yes
Title	string	No

DeleteURLRequest

Field	Type	Required
Domain	string	Yes
Slug	string	Yes

Error Handling

All methods return standard Go errors. Always check for errors:

resp, err := client.CreateShortURL(req)
if err != nil {
    log.Printf("Failed: %v", err)
    return
}

Example

See examples/main.go for complete working examples.

cd examples && go run main.go

Contributing

Issues and Pull Requests are welcome!

License

MIT License