kutt-go

Kutt.it API Client for Go and CLI tool

Kutt.it is a Modern Open Source URL shortener.

• Custom domain
• Password for the URL
• Managing links
• Free & Open Source
• 50 URLs shortening per day.

This repo contains a CLI and golang package for the service.

CLI

Installation

$ go install github.com/raahii/kutt-go/cmd/kutt@latest

Usage

$ kutt register <your api key>
$ kutt submit <url to shorten>
https://kutt.it/ztPDmK

❯ kutt --help
CLI tool for Kutt.it (URL Shortener)

Usage:
  kutt [command]

Available Commands:
  apikey      Register your api key to cli
  delete      Delete a shorted link (Give me url id or url shorted)
  list        List of last 5 URL objects.
  submit      Submit a new short URL
  help        Help about any command

Flags:
  -k, --apikey string   api key for Kutt.it
  -h, --help            help for kutt

Use "kutt [command] --help" for more information about a command.

Go Package

Installation

$ go get -u github.com/raahii/kutt-go

Example

This is a example to get shorter url. See also codes in _example directory.

package main

import (
	"fmt"
	"log"

	"github.com/raahii/kutt-go"
)

func main() {
	cli := kutt.NewClient("<api key>")

	// create a short url
	target := "https://github.com/raahii/kutt-go"
	URL, err := cli.Submit(
		target,
		// kutt.WithCustomURL("kutt-go"),
		// kutt.WithPassword("foobar"),
		// kutt.WithReuse(true),
	)
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(URL.ShortURL) // https://kutt.it/kutt-go
}

type URL struct {
	ID         string    `json:"id"`
	Target     string    `json:"target"`
	ShortURL   string    `json:"shortUrl"`
	Password   bool      `json:"password"`
	Reuse      bool      `json:"reuse"`
	DomainID   string    `json:"domain_id"`
	VisitCount int       `json:"visit_count"`
	CreatedAt  time.Time `json:"created_at"`
	UpdatedAt  time.Time `json:"updated_at"`
}

Reference

• thedevs-network/kutt: Free Modern URL Shortener.
• Kutt API v2 documentation

Licence

Code released under the MIT License.