https://github.com/libdns/netcup

Netcup provider implementation for libdns
https://github.com/libdns/netcup

libdns netcup

Last synced: 4 months ago
JSON representation

Netcup provider implementation for libdns

• Host: GitHub
• URL: https://github.com/libdns/netcup
• Owner: libdns
• License: mit
• Created: 2022-01-10T19:30:11.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2025-06-09T15:52:25.000Z (12 months ago)
• Last Synced: 2025-06-09T16:42:22.525Z (12 months ago)
• Topics: libdns, netcup
• Language: Go
• Homepage:
• Size: 8.79 KB
• Stars: 7
• Watchers: 3
• Forks: 10
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# netcup for [`libdns`](https://github.com/libdns/libdns)

[![Go Reference](https://pkg.go.dev/badge/test.svg)](https://pkg.go.dev/github.com/libdns/netcup)

This package implements the [libdns interfaces](https://github.com/libdns/libdns) for the [netcup DNS API](https://ccp.netcup.net/run/webservice/servers/endpoint.php), allowing you to manage DNS records.

## Configuration

The provider is configured by instantiating the `netcup.Provider` with the customer number, the API key and the API password for the DNS API obtained from netcup ([guide](https://www.netcup-wiki.de/wiki/CCP_API)).

Here is a minimal working example to get all DNS records using environment variables for the credentials:

```go

import (

	"context"

	"fmt"

	"os"

	"github.com/libdns/netcup"

)

func main() {

	provider := netcup.Provider{

		CustomerNumber: os.Getenv("LIBDNS_NETCUP_CUSTOMER_NUMBER"),

		APIKey:         os.Getenv("LIBDNS_NETCUP_API_KEY"),

		APIPassword:    os.Getenv("LIBDNS_NETCUP_API_PASSWORD"),

	}

	ctx := context.TODO()

	zone := os.Getenv("LIBDNS_NETCUP_ZONE")

	records, err := provider.GetRecords(ctx, zone)

	if err != nil {

		fmt.Println(err.Error())

		return

	}

	for _, record := range records {

		fmt.Printf("%+v\n", record)

	}

}

```

## Usage

**:warning: The netcup API does not offer setting the TTL for individual records.**

**:warning: As the ID attribute has been removed in the libdns record structs, using the ID field is not possible.**

Updating and deleting records can be done by either filling all struct fields of the dnsRecord, or just Name and Type (+ Priority for MX records). Then the first record matching these criteria is updated/deleted.