From paultyng/go-unifi

filipowm/go-unifi started as a fork of paultyng/go-unifi. The resource methods are the same, so most of your code keeps working unchanged. What differs is how you construct and authenticate the client — and you gain a larger API surface, structured configuration, and the Official UniFi OpenAPI on top.

Client construction

The biggest change is moving from a manually-configured struct to a single NewClient constructor.

client := unifi.Client{}
client.SetBaseURL("https://unifi.localdomain")

// Optional: configure TLS by hand
if skipTLSVerify {
	httpClient := &http.Client{
		Transport: &http.Transport{
			TLSClientConfig: &tls.Config{InsecureSkipVerify: true},
		},
	}
	jar, _ := cookiejar.New(nil)
	httpClient.Jar = jar
	client.SetHTTPClient(httpClient)
}

// Login is required
if err := client.Login(ctx, username, password); err != nil {
	return nil, err
}

client, err := unifi.NewClient(&unifi.ClientConfig{
	URL:    "https://unifi.localdomain",
	APIKey: "your-api-key",
})
if err != nil {
	log.Fatalf("create client: %v", err)
}

NewClient validates the connection and your API key up front, so there is no separate Login() step. In 2.0.0 the only supported authentication is an API key, available from UniFi Network controller 9.0.114 and newer.

Key differences

TLS verification

TLS verification is now on by default (secure by default). To skip verification — for example against a controller with a self-signed certificate — set SkipVerifySSL: true. The zero value (false) verifies, and disabling verification logs a warning on every client build:

client, err := unifi.NewClient(&unifi.ClientConfig{
	URL:           "https://unifi.localdomain",
	APIKey:        "your-api-key",
	SkipVerifySSL: true,
})

For finer control you can replace the transport entirely with HttpRoundTripperProvider, or tweak the default one with HttpTransportCustomizer — see Configuration.

Error handling

Replace any reference to unifi.APIError with unifi.ServerError. It carries the controller's status, method, URL, message, and code:

n := &unifi.Network{Name: "lab"}
_, err := c.CreateNetwork(ctx, "default", n)

var serverErr *unifi.ServerError
if errors.As(err, &serverErr) {
	log.Printf("controller error %d: %s", serverErr.StatusCode, serverErr.Message)
}

A genuine HTTP 404 from any endpoint also satisfies errors.Is(err, unifi.ErrNotFound).

What you gain

Beyond the resource methods you already use, filipowm/go-unifi adds:

Migration steps

The rest of your code — the resource methods — should continue to work as before.