dnsimple

package
v0.22.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 16, 2018 License: MIT Imports: 12 Imported by: 0

Documentation

Overview

Package dnsimple provides a client for the DNSimple API. In order to use this package you will need a DNSimple account.

Index

Constants

View Source
const (
	// AuthorizationCodeGrant is the type of access token request
	// for an Authorization Code Grant flow.
	// https://tools.ietf.org/html/rfc6749#section-4.1
	AuthorizationCodeGrant = GrantType("authorization_code")
)
View Source
const (
	// Version identifies the current library version.
	// This is a pro-forma convention given that Go dependencies
	// tends to be fetched directly from the repo.
	// It is also used in the user-agent identify the client.
	Version = "0.22.0"
)

Variables

This section is empty.

Functions

func CheckResponse

func CheckResponse(resp *http.Response) error

CheckResponse checks the API response for errors, and returns them if present. A response is considered an error if the status code is different than 2xx. Specific requests may have additional requirements, but this is sufficient in most of the cases.

Types

type AccessToken

type AccessToken struct {
	Token     string `json:"access_token"`
	Type      string `json:"token_type"`
	AccountID int    `json:"account_id"`
}

AccessToken represents a DNSimple Oauth access token.

type Account

type Account struct {
	ID             int64  `json:"id,omitempty"`
	Email          string `json:"email,omitempty"`
	PlanIdentifier string `json:"plan_identifier,omitempty"`
	CreatedAt      string `json:"created_at,omitempty"`
	UpdatedAt      string `json:"updated_at,omitempty"`
}

Account represents a DNSimple account.

type AccountsService added in v0.13.0

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

func (*AccountsService) ListAccounts added in v0.13.0

func (s *AccountsService) ListAccounts(options *ListOptions) (*accountsResponse, error)

ListAccounts list the accounts for an user.

See https://developer.dnsimple.com/v2/accounts/#list

type AuthorizationOptions

type AuthorizationOptions struct {
	RedirectURI string `url:"redirect_uri,omitempty"`
	// A randomly generated string to verify the validity of the request.
	// Currently "state" is required by the DNSimple OAuth implementation, so you must specify it.
	State string `url:"state,omitempty"`
}

AuthorizationOptions represents the option you can use to generate an authorization URL.

type BasicAuthTransport added in v0.20.0

type BasicAuthTransport struct {
	Username string
	Password string

	// Transport is the transport RoundTripper used to make HTTP requests.
	// If nil, http.DefaultTransport is used.
	Transport http.RoundTripper
}

BasicAuthTransport is an http.RoundTripper that authenticates all requests using HTTP Basic Authentication with the provided username and password.

func (*BasicAuthTransport) Client added in v0.20.0

func (t *BasicAuthTransport) Client() *http.Client

Client returns an *http.Client that uses the BasicAuthTransport transport to authenticate the request via HTTP Basic Auth.

func (*BasicAuthTransport) RoundTrip added in v0.20.0

func (t *BasicAuthTransport) RoundTrip(req *http.Request) (*http.Response, error)

RoundTrip implements the RoundTripper interface. We just add the basic auth and return the RoundTripper for this transport type.

type Certificate added in v0.13.0

type Certificate struct {
	ID                  int64    `json:"id,omitempty"`
	DomainID            int64    `json:"domain_id,omitempty"`
	ContactID           int64    `json:"contact_id,omitempty"`
	CommonName          string   `json:"common_name,omitempty"`
	AlternateNames      []string `json:"alternate_names,omitempty"`
	Years               int      `json:"years,omitempty"`
	State               string   `json:"state,omitempty"`
	AuthorityIdentifier string   `json:"authority_identifier,omitempty"`
	AutoRenew           bool     `json:"auto_renew"`
	CreatedAt           string   `json:"created_at,omitempty"`
	UpdatedAt           string   `json:"updated_at,omitempty"`
	ExpiresOn           string   `json:"expires_on,omitempty"`
	CertificateRequest  string   `json:"csr,omitempty"`
}

Certificate represents a Certificate in DNSimple.

type CertificateBundle added in v0.13.0

type CertificateBundle struct {
	// CertificateRequest       string   `json:"csr,omitempty"`
	PrivateKey               string   `json:"private_key,omitempty"`
	ServerCertificate        string   `json:"server,omitempty"`
	RootCertificate          string   `json:"root,omitempty"`
	IntermediateCertificates []string `json:"chain,omitempty"`
}

CertificateBundle represents a container for all the PEM-encoded X509 certificate entities, such as the private key, the server certificate and the intermediate chain.

type CertificatePurchase added in v0.16.0

type CertificatePurchase struct {
	ID            int64  `json:"id,omitempty"`
	CertificateID int64  `json:"new_certificate_id,omitempty"`
	State         string `json:"state,omitempty"`
	AutoRenew     bool   `json:"auto_renew,omitempty"`
	CreatedAt     string `json:"created_at,omitempty"`
	UpdatedAt     string `json:"updated_at,omitempty"`
}

CertificatePurchase represents a Certificate Purchase in DNSimple.

type CertificateRenewal added in v0.16.0

type CertificateRenewal struct {
	ID               int64  `json:"id,omitempty"`
	OldCertificateID int64  `json:"old_certificate_id,omitempty"`
	NewCertificateID int64  `json:"new_certificate_id,omitempty"`
	State            string `json:"state,omitempty"`
	AutoRenew        bool   `json:"auto_renew,omitempty"`
	CreatedAt        string `json:"created_at,omitempty"`
	UpdatedAt        string `json:"updated_at,omitempty"`
}

CertificateRenewal represents a Certificate Renewal in DNSimple.

type CertificatesService added in v0.13.0

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

CertificatesService handles communication with the certificate related methods of the DNSimple API.

See https://developer.dnsimple.com/v2/certificates

func (*CertificatesService) DownloadCertificate added in v0.13.0

func (s *CertificatesService) DownloadCertificate(accountID, domainIdentifier string, certificateID int64) (*certificateBundleResponse, error)

DownloadCertificate gets the PEM-encoded certificate, along with the root certificate and intermediate chain.

See https://developer.dnsimple.com/v2/certificates#downloadCertificate

func (*CertificatesService) GetCertificate added in v0.13.0

func (s *CertificatesService) GetCertificate(accountID, domainIdentifier string, certificateID int64) (*certificateResponse, error)

GetCertificate gets the details of a certificate.

See https://developer.dnsimple.com/v2/certificates#getCertificate

func (*CertificatesService) GetCertificatePrivateKey added in v0.13.0

func (s *CertificatesService) GetCertificatePrivateKey(accountID, domainIdentifier string, certificateID int64) (*certificateBundleResponse, error)

GetCertificatePrivateKey gets the PEM-encoded certificate private key.

See https://developer.dnsimple.com/v2/certificates#getCertificatePrivateKey

func (*CertificatesService) IssueLetsencryptCertificate added in v0.16.0

func (s *CertificatesService) IssueLetsencryptCertificate(accountID, domainIdentifier string, certificateID int64) (*certificateResponse, error)

IssueLetsencryptCertificate issues a pending Let's Encrypt certificate purchase order.

See https://developer.dnsimple.com/v2/certificates/#issueLetsencryptCertificate

func (*CertificatesService) IssueLetsencryptCertificateRenewal added in v0.16.0

func (s *CertificatesService) IssueLetsencryptCertificateRenewal(accountID, domainIdentifier string, certificateID, certificateRenewalID int64) (*certificateResponse, error)

IssueLetsencryptCertificateRenewal issues a pending Let's Encrypt certificate renewal order.

See https://developer.dnsimple.com/v2/certificates/#issueRenewalLetsencryptCertificate

func (*CertificatesService) ListCertificates added in v0.13.0

func (s *CertificatesService) ListCertificates(accountID, domainIdentifier string, options *ListOptions) (*certificatesResponse, error)

ListCertificates lists the certificates for a domain in the account.

See https://developer.dnsimple.com/v2/certificates#listCertificates

func (*CertificatesService) PurchaseLetsencryptCertificate added in v0.16.0

func (s *CertificatesService) PurchaseLetsencryptCertificate(accountID, domainIdentifier string, certificateAttributes LetsencryptCertificateAttributes) (*certificatePurchaseResponse, error)

PurchaseLetsencryptCertificate purchases a Let's Encrypt certificate.

See https://developer.dnsimple.com/v2/certificates/#purchaseLetsencryptCertificate

func (*CertificatesService) PurchaseLetsencryptCertificateRenewal added in v0.16.0

func (s *CertificatesService) PurchaseLetsencryptCertificateRenewal(accountID, domainIdentifier string, certificateID int64, certificateAttributes LetsencryptCertificateAttributes) (*certificateRenewalResponse, error)

PurchaseLetsencryptCertificateRenewal purchases a Let's Encrypt certificate renewal.

See https://developer.dnsimple.com/v2/certificates/#purchaseRenewalLetsencryptCertificate

type Client

type Client struct {

	// BaseURL for API requests.
	// Defaults to the public DNSimple API, but can be set to a different endpoint (e.g. the sandbox).
	BaseURL string

	// UserAgent used when communicating with the DNSimple API.
	UserAgent string

	// Services used for talking to different parts of the DNSimple API.
	Identity          *IdentityService
	Accounts          *AccountsService
	Certificates      *CertificatesService
	Contacts          *ContactsService
	Domains           *DomainsService
	Oauth             *OauthService
	Registrar         *RegistrarService
	Services          *ServicesService
	Templates         *TemplatesService
	Tlds              *TldsService
	VanityNameServers *VanityNameServersService
	Webhooks          *WebhooksService
	Zones             *ZonesService

	// Set to true to output debugging logs during API calls
	Debug bool
	// contains filtered or unexported fields
}

Client represents a client to the DNSimple API.

func NewClient

func NewClient(httpClient *http.Client) *Client

NewClient returns a new DNSimple API client.

To authenticate you must provide an http.Client that will perform authentication for you with one of the currently supported mechanisms: OAuth or HTTP Basic.

func (*Client) Do

func (c *Client) Do(req *http.Request, obj interface{}) (*http.Response, error)

Do sends an API request and returns the API response.

The API response is JSON decoded and stored in the value pointed by obj, or returned as an error if an API error has occurred. If obj implements the io.Writer interface, the raw response body will be written to obj, without attempting to decode it.

func (*Client) NewRequest

func (c *Client) NewRequest(method, path string, payload interface{}) (*http.Request, error)

NewRequest creates an API request. The path is expected to be a relative path and will be resolved according to the BaseURL of the Client. Paths should always be specified without a preceding slash.

type Collaborator added in v0.14.0

type Collaborator struct {
	ID         int64  `json:"id,omitempty"`
	DomainID   int64  `json:"domain_id,omitempty"`
	DomainName string `json:"domain_name,omitempty"`
	UserID     int64  `json:"user_id,omitempty"`
	UserEmail  string `json:"user_email,omitempty"`
	Invitation bool   `json:"invitation,omitempty"`
	CreatedAt  string `json:"created_at,omitempty"`
	UpdatedAt  string `json:"updated_at,omitempty"`
	AcceptedAt string `json:"accepted_at,omitempty"`
}

Collaborator represents a Collaborator in DNSimple.

type CollaboratorAttributes added in v0.14.0

type CollaboratorAttributes struct {
	Email string `json:"email,omitempty"`
}

CollaboratorAttributes represents Collaborator attributes for AddCollaborator operation.

type Contact

type Contact struct {
	ID            int64  `json:"id,omitempty"`
	AccountID     int64  `json:"account_id,omitempty"`
	Label         string `json:"label,omitempty"`
	FirstName     string `json:"first_name,omitempty"`
	LastName      string `json:"last_name,omitempty"`
	JobTitle      string `json:"job_title,omitempty"`
	Organization  string `json:"organization_name,omitempty"`
	Address1      string `json:"address1,omitempty"`
	Address2      string `json:"address2,omitempty"`
	City          string `json:"city,omitempty"`
	StateProvince string `json:"state_province,omitempty"`
	PostalCode    string `json:"postal_code,omitempty"`
	Country       string `json:"country,omitempty"`
	Phone         string `json:"phone,omitempty"`
	Fax           string `json:"fax,omitempty"`
	Email         string `json:"email,omitempty"`
	CreatedAt     string `json:"created_at,omitempty"`
	UpdatedAt     string `json:"updated_at,omitempty"`
}

Contact represents a Contact in DNSimple.

type ContactsService

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

ContactsService handles communication with the contact related methods of the DNSimple API.

See https://developer.dnsimple.com/v2/contacts/

func (*ContactsService) CreateContact

func (s *ContactsService) CreateContact(accountID string, contactAttributes Contact) (*contactResponse, error)

CreateContact creates a new contact.

See https://developer.dnsimple.com/v2/contacts/#create

func (*ContactsService) DeleteContact

func (s *ContactsService) DeleteContact(accountID string, contactID int64) (*contactResponse, error)

DeleteContact PERMANENTLY deletes a contact from the account.

See https://developer.dnsimple.com/v2/contacts/#delete

func (*ContactsService) GetContact

func (s *ContactsService) GetContact(accountID string, contactID int64) (*contactResponse, error)

GetContact fetches a contact.

See https://developer.dnsimple.com/v2/contacts/#get

func (*ContactsService) ListContacts

func (s *ContactsService) ListContacts(accountID string, options *ListOptions) (*contactsResponse, error)

ListContacts list the contacts for an account.

See https://developer.dnsimple.com/v2/contacts/#list

func (*ContactsService) UpdateContact

func (s *ContactsService) UpdateContact(accountID string, contactID int64, contactAttributes Contact) (*contactResponse, error)

UpdateContact updates a contact.

See https://developer.dnsimple.com/v2/contacts/#update

type Delegation

type Delegation []string

Delegation represents a list of name servers that correspond to a domain delegation.

type DelegationSignerRecord added in v0.15.0

type DelegationSignerRecord struct {
	ID         int64  `json:"id,omitempty"`
	DomainID   int64  `json:"domain_id,omitempty"`
	Algorithm  string `json:"algorithm"`
	Digest     string `json:"digest"`
	DigestType string `json:"digest_type"`
	Keytag     string `json:"keytag"`
	CreatedAt  string `json:"created_at,omitempty"`
	UpdatedAt  string `json:"updated_at,omitempty"`
}

DelegationSignerRecord represents a delegation signer record for a domain in DNSimple.

type Dnssec added in v0.15.0

type Dnssec struct {
	Enabled bool `json:"enabled"`
}

Dnssec represents the current DNSSEC settings for a domain in DNSimple.

type Domain

type Domain struct {
	ID           int64  `json:"id,omitempty"`
	AccountID    int64  `json:"account_id,omitempty"`
	RegistrantID int64  `json:"registrant_id,omitempty"`
	Name         string `json:"name,omitempty"`
	UnicodeName  string `json:"unicode_name,omitempty"`
	Token        string `json:"token,omitempty"`
	State        string `json:"state,omitempty"`
	AutoRenew    bool   `json:"auto_renew,omitempty"`
	PrivateWhois bool   `json:"private_whois,omitempty"`
	ExpiresOn    string `json:"expires_on,omitempty"`
	CreatedAt    string `json:"created_at,omitempty"`
	UpdatedAt    string `json:"updated_at,omitempty"`
}

Domain represents a domain in DNSimple.

type DomainCheck

type DomainCheck struct {
	Domain    string `json:"domain"`
	Available bool   `json:"available"`
	Premium   bool   `json:"premium"`
}

DomainCheck represents the result of a domain check.

type DomainListOptions

type DomainListOptions struct {
	// Select domains where the name contains given string.
	NameLike string `url:"name_like,omitempty"`

	// Select domains where the registrant matches given ID.
	RegistrantID int `url:"registrant_id,omitempty"`

	ListOptions
}

DomainListOptions specifies the optional parameters you can provide to customize the DomainsService.ListDomains method.

type DomainPremiumPrice added in v0.14.0

type DomainPremiumPrice struct {
	// The domain premium price
	PremiumPrice string `json:"premium_price"`
	// The registrar action.
	// Possible values are registration|transfer|renewal
	Action string `json:"action"`
}

DomainPremiumPrice represents the premium price for a premium domain.

type DomainPremiumPriceOptions added in v0.14.0

type DomainPremiumPriceOptions struct {
	Action string `url:"action,omitempty"`
}

DomainPremiumPriceOptions specifies the optional parameters you can provide to customize the RegistrarService.GetDomainPremiumPrice method.

type DomainPush added in v0.14.0

type DomainPush struct {
	ID         int64  `json:"id,omitempty"`
	DomainID   int64  `json:"domain_id,omitempty"`
	ContactID  int64  `json:"contact_id,omitempty"`
	AccountID  int64  `json:"account_id,omitempty"`
	CreatedAt  string `json:"created_at,omitempty"`
	UpdatedAt  string `json:"updated_at,omitempty"`
	AcceptedAt string `json:"accepted_at,omitempty"`
}

DomainPush represents a domain push in DNSimple.

type DomainPushAttributes added in v0.14.0

type DomainPushAttributes struct {
	NewAccountEmail string `json:"new_account_email,omitempty"`
	ContactID       int64  `json:"contact_id,omitempty"`
}

DomainPushAttributes represent a domain push payload (see initiate).

type DomainRegisterRequest

type DomainRegisterRequest struct {
	// The ID of the Contact to use as registrant for the domain
	RegistrantID int `json:"registrant_id"`
	// Set to true to enable the whois privacy service. An extra cost may apply.
	// Default to false.
	EnableWhoisPrivacy bool `json:"whois_privacy,omitempty"`
	// Set to true to enable the auto-renewal of the domain.
	// Default to true.
	EnableAutoRenewal bool `json:"auto_renew,omitempty"`
	// Required as confirmation of the price, only if the domain is premium.
	PremiumPrice string `json:"premium_price,omitempty"`
}

DomainRegisterRequest represents the attributes you can pass to a register API request. Some attributes are mandatory.

type DomainRegistration added in v0.14.0

type DomainRegistration struct {
	ID           int    `json:"id"`
	DomainID     int    `json:"domain_id"`
	RegistrantID int    `json:"registrant_id"`
	Period       int    `json:"period"`
	State        string `json:"state"`
	AutoRenew    bool   `json:"auto_renew"`
	WhoisPrivacy bool   `json:"whois_privacy"`
	CreatedAt    string `json:"created_at,omitempty"`
	UpdatedAt    string `json:"updated_at,omitempty"`
}

DomainRegistration represents the result of a domain renewal call.

type DomainRenewRequest

type DomainRenewRequest struct {
	// The number of years
	Period int `json:"period"`
	// Required as confirmation of the price, only if the domain is premium.
	PremiumPrice string `json:"premium_price,omitempty"`
}

DomainRenewRequest represents the attributes you can pass to a renew API request. Some attributes are mandatory.

type DomainRenewal added in v0.14.0

type DomainRenewal struct {
	ID        int    `json:"id"`
	DomainID  int    `json:"domain_id"`
	Period    int    `json:"period"`
	State     string `json:"state"`
	CreatedAt string `json:"created_at,omitempty"`
	UpdatedAt string `json:"updated_at,omitempty"`
}

DomainRenewal represents the result of a domain renewal call.

type DomainServiceSettings added in v0.13.0

type DomainServiceSettings struct {
	Settings map[string]string `url:"settings,omitempty"`
}

DomainServiceSettings represents optional settings when applying a DNSimple one-click service to a domain.

type DomainTransfer added in v0.14.0

type DomainTransfer struct {
	ID           int    `json:"id"`
	DomainID     int    `json:"domain_id"`
	RegistrantID int    `json:"registrant_id"`
	State        string `json:"state"`
	AutoRenew    bool   `json:"auto_renew"`
	WhoisPrivacy bool   `json:"whois_privacy"`
	CreatedAt    string `json:"created_at,omitempty"`
	UpdatedAt    string `json:"updated_at,omitempty"`
}

DomainTransfer represents the result of a domain renewal call.

type DomainTransferRequest

type DomainTransferRequest struct {
	// The ID of the Contact to use as registrant for the domain
	RegistrantID int `json:"registrant_id"`
	// The Auth-Code required to transfer the domain.
	// This is provided by the current registrar of the domain.
	AuthCode string `json:"auth_code,omitempty"`
	// Set to true to enable the whois privacy service. An extra cost may apply.
	// Default to false.
	EnableWhoisPrivacy bool `json:"whois_privacy,omitempty"`
	// Set to true to enable the auto-renewal of the domain.
	// Default to true.
	EnableAutoRenewal bool `json:"auto_renew,omitempty"`
	// Required as confirmation of the price, only if the domain is premium.
	PremiumPrice string `json:"premium_price,omitempty"`
}

DomainTransferRequest represents the attributes you can pass to a transfer API request. Some attributes are mandatory.

type DomainsService

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

DomainsService handles communication with the domain related methods of the DNSimple API.

See https://developer.dnsimple.com/v2/domains/

func (*DomainsService) AcceptPush added in v0.14.0

func (s *DomainsService) AcceptPush(accountID string, pushID int64, pushAttributes DomainPushAttributes) (*domainPushResponse, error)

AcceptPush accept a push for a domain.

See https://developer.dnsimple.com/v2/domains/pushes/#accept

func (*DomainsService) AddCollaborator added in v0.14.0

func (s *DomainsService) AddCollaborator(accountID string, domainIdentifier string, attributes CollaboratorAttributes) (*collaboratorResponse, error)

AddCollaborator adds a new collaborator to the domain in the account.

See https://developer.dnsimple.com/v2/domains/collaborators#add

func (*DomainsService) CreateDelegationSignerRecord added in v0.15.0

func (s *DomainsService) CreateDelegationSignerRecord(accountID string, domainIdentifier string, dsRecordAttributes DelegationSignerRecord) (*delegationSignerRecordResponse, error)

CreateDelegationSignerRecord creates a new delegation signer record.

See https://developer.dnsimple.com/v2/domains/dnssec/#ds-record-create

func (*DomainsService) CreateDomain

func (s *DomainsService) CreateDomain(accountID string, domainAttributes Domain) (*domainResponse, error)

CreateDomain creates a new domain in the account.

See https://developer.dnsimple.com/v2/domains/#create

func (*DomainsService) CreateEmailForward

func (s *DomainsService) CreateEmailForward(accountID string, domainIdentifier string, forwardAttributes EmailForward) (*emailForwardResponse, error)

CreateEmailForward creates a new email forward.

See https://developer.dnsimple.com/v2/domains/email-forwards/#create

func (*DomainsService) DeleteDelegationSignerRecord added in v0.15.0

func (s *DomainsService) DeleteDelegationSignerRecord(accountID string, domainIdentifier string, dsRecordID int64) (*delegationSignerRecordResponse, error)

DeleteDelegationSignerRecord PERMANENTLY deletes a delegation signer record from the domain.

See https://developer.dnsimple.com/v2/domains/dnssec/#ds-record-delete

func (*DomainsService) DeleteDomain

func (s *DomainsService) DeleteDomain(accountID string, domainIdentifier string) (*domainResponse, error)

DeleteDomain PERMANENTLY deletes a domain from the account.

See https://developer.dnsimple.com/v2/domains/#delete

func (*DomainsService) DeleteEmailForward

func (s *DomainsService) DeleteEmailForward(accountID string, domainIdentifier string, forwardID int64) (*emailForwardResponse, error)

DeleteEmailForward PERMANENTLY deletes an email forward from the domain.

See https://developer.dnsimple.com/v2/domains/email-forwards/#delete

func (*DomainsService) DisableDnssec added in v0.15.0

func (s *DomainsService) DisableDnssec(accountID string, domainIdentifier string) (*dnssecResponse, error)

DisableDnssec disables DNSSEC on the domain.

See https://developer.dnsimple.com/v2/domains/dnssec/#disable

func (*DomainsService) EnableDnssec added in v0.15.0

func (s *DomainsService) EnableDnssec(accountID string, domainIdentifier string) (*dnssecResponse, error)

func (*DomainsService) GetDelegationSignerRecord added in v0.15.0

func (s *DomainsService) GetDelegationSignerRecord(accountID string, domainIdentifier string, dsRecordID int64) (*delegationSignerRecordResponse, error)

GetDelegationSignerRecord fetches a delegation signer record.

See https://developer.dnsimple.com/v2/domains/dnssec/#ds-record-get

func (*DomainsService) GetDnssec added in v0.15.0

func (s *DomainsService) GetDnssec(accountID string, domainIdentifier string) (*dnssecResponse, error)

GetDnssec retrieves the current status of DNSSEC on the domain.

See https://developer.dnsimple.com/v2/domains/dnssec/#get

func (*DomainsService) GetDomain

func (s *DomainsService) GetDomain(accountID string, domainIdentifier string) (*domainResponse, error)

GetDomain fetches a domain.

See https://developer.dnsimple.com/v2/domains/#get

func (*DomainsService) GetEmailForward

func (s *DomainsService) GetEmailForward(accountID string, domainIdentifier string, forwardID int64) (*emailForwardResponse, error)

GetEmailForward fetches an email forward.

See https://developer.dnsimple.com/v2/domains/email-forwards/#get

func (*DomainsService) InitiatePush added in v0.14.0

func (s *DomainsService) InitiatePush(accountID, domainID string, pushAttributes DomainPushAttributes) (*domainPushResponse, error)

InitiatePush initiate a new domain push.

See https://developer.dnsimple.com/v2/domains/pushes/#initiate

func (*DomainsService) ListCollaborators added in v0.14.0

func (s *DomainsService) ListCollaborators(accountID, domainIdentifier string, options *ListOptions) (*collaboratorsResponse, error)

ListCollaborators list the collaborators for a domain.

See https://developer.dnsimple.com/v2/domains/collaborators#list

func (*DomainsService) ListDelegationSignerRecords added in v0.15.0

func (s *DomainsService) ListDelegationSignerRecords(accountID string, domainIdentifier string, options *ListOptions) (*delegationSignerRecordsResponse, error)

ListDelegationSignerRecords lists the delegation signer records for a domain.

See https://developer.dnsimple.com/v2/domains/dnssec/#ds-record-list

func (*DomainsService) ListDomains

func (s *DomainsService) ListDomains(accountID string, options *DomainListOptions) (*domainsResponse, error)

ListDomains lists the domains for an account.

See https://developer.dnsimple.com/v2/domains/#list

func (*DomainsService) ListEmailForwards

func (s *DomainsService) ListEmailForwards(accountID string, domainIdentifier string, options *ListOptions) (*emailForwardsResponse, error)

ListEmailForwards lists the email forwards for a domain.

See https://developer.dnsimple.com/v2/domains/email-forwards/#list

func (*DomainsService) ListPushes added in v0.14.0

func (s *DomainsService) ListPushes(accountID string, options *ListOptions) (*domainPushesResponse, error)

ListPushes lists the pushes for an account.

See https://developer.dnsimple.com/v2/domains/pushes/#list

func (*DomainsService) RejectPush added in v0.14.0

func (s *DomainsService) RejectPush(accountID string, pushID int64) (*domainPushResponse, error)

RejectPush reject a push for a domain.

See https://developer.dnsimple.com/v2/domains/pushes/#reject

func (*DomainsService) RemoveCollaborator added in v0.14.0

func (s *DomainsService) RemoveCollaborator(accountID string, domainIdentifier string, collaboratorID int64) (*collaboratorResponse, error)

RemoveCollaborator PERMANENTLY deletes a domain from the account.

See https://developer.dnsimple.com/v2/domains/collaborators#remove

func (*DomainsService) ResetDomainToken

func (s *DomainsService) ResetDomainToken(accountID string, domainIdentifier string) (*domainResponse, error)

DEPRECATED

See https://developer.dnsimple.com/v2/domains/#reset-token

type EmailForward

type EmailForward struct {
	ID        int64  `json:"id,omitempty"`
	DomainID  int64  `json:"domain_id,omitempty"`
	From      string `json:"from,omitempty"`
	To        string `json:"to,omitempty"`
	CreatedAt string `json:"created_at,omitempty"`
	UpdatedAt string `json:"updated_at,omitempty"`
}

EmailForward represents an email forward in DNSimple.

type ErrorResponse

type ErrorResponse struct {
	Response

	// human-readable message
	Message string `json:"message"`
}

An ErrorResponse represents an API response that generated an error.

func (*ErrorResponse) Error

func (r *ErrorResponse) Error() string

Error implements the error interface.

type ExchangeAuthorizationError

type ExchangeAuthorizationError struct {
	// HTTP response
	HttpResponse *http.Response

	ErrorCode        string `json:"error"`
	ErrorDescription string `json:"error_description"`
}

ExchangeAuthorizationError represents a failed request to exchange an authorization code for an access token.

func (*ExchangeAuthorizationError) Error

Error implements the error interface.

type ExchangeAuthorizationRequest

type ExchangeAuthorizationRequest struct {
	Code         string    `json:"code"`
	ClientID     string    `json:"client_id"`
	ClientSecret string    `json:"client_secret"`
	RedirectURI  string    `json:"redirect_uri,omitempty"`
	State        string    `json:"state,omitempty"`
	GrantType    GrantType `json:"grant_type,omitempty"`
}

ExchangeAuthorizationRequest represents a request to exchange an authorization code for an access token. RedirectURI is optional, all the other fields are mandatory.

type GrantType

type GrantType string

GrantType is a string that identifies a particular grant type in the exchange request.

type IdentityService

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

IdentityService handles communication with several authentication identity methods of the DNSimple API.

See https://developer.dnsimple.com/v2/identity/

func (*IdentityService) Whoami

func (s *IdentityService) Whoami() (*whoamiResponse, error)

Whoami gets the current authenticate context.

See https://developer.dnsimple.com/v2/whoami

type LetsencryptCertificateAttributes added in v0.16.0

type LetsencryptCertificateAttributes struct {
	ContactID      int64    `json:"contact_id,omitempty"`
	Name           string   `json:"name,omitempty"`
	AutoRenew      bool     `json:"auto_renew,omitempty"`
	AlternateNames []string `json:"alternate_names,omitempty"`
}

LetsencryptCertificateAttributes is a set of attributes to purchase a Let's Encrypt certificate.

type ListOptions

type ListOptions struct {
	// The page to return
	Page int `url:"page,omitempty"`

	// The number of entries to return per page
	PerPage int `url:"per_page,omitempty"`

	// The order criteria to sort the results.
	// The value is a comma-separated list of field[:direction],
	// eg. name | name:desc | name:desc,expiration:desc
	Sort string `url:"sort,omitempty"`
}

ListOptions contains the common options you can pass to a List method in order to control parameters such as paginations and page number.

type OauthService

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

OauthService handles communication with the authorization related methods of the DNSimple API.

See https://developer.dnsimple.com/v2/oauth/

func (*OauthService) AuthorizeURL

func (s *OauthService) AuthorizeURL(clientID string, options *AuthorizationOptions) string

AuthorizeURL generates the URL to authorize an user for an application via the OAuth2 flow.

func (*OauthService) ExchangeAuthorizationForToken

func (s *OauthService) ExchangeAuthorizationForToken(authorization *ExchangeAuthorizationRequest) (*AccessToken, error)

ExchangeAuthorizationForToken exchanges the short-lived authorization code for an access token you can use to authenticate your API calls.

type Pagination

type Pagination struct {
	CurrentPage  int `json:"current_page"`
	PerPage      int `json:"per_page"`
	TotalPages   int `json:"total_pages"`
	TotalEntries int `json:"total_entries"`
}

If the response is paginated, Pagination represents the pagination information.

type RegistrarService

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

RegistrarService handles communication with the registrar related methods of the DNSimple API.

See https://developer.dnsimple.com/v2/registrar/

func (*RegistrarService) ChangeDomainDelegation

func (s *RegistrarService) ChangeDomainDelegation(accountID string, domainName string, newDelegation *Delegation) (*delegationResponse, error)

ChangeDomainDelegation updates the delegated name severs for the domain.

See https://developer.dnsimple.com/v2/registrar/delegation/#get

func (*RegistrarService) ChangeDomainDelegationFromVanity added in v0.13.0

func (s *RegistrarService) ChangeDomainDelegationFromVanity(accountID string, domainName string) (*vanityDelegationResponse, error)

ChangeDomainDelegationFromVanity disables vanity name servers for the given domain.

See https://developer.dnsimple.com/v2/registrar/delegation/#dedelegateFromVanity

func (*RegistrarService) ChangeDomainDelegationToVanity added in v0.13.0

func (s *RegistrarService) ChangeDomainDelegationToVanity(accountID string, domainName string, newDelegation *Delegation) (*vanityDelegationResponse, error)

ChangeDomainDelegationToVanity enables vanity name servers for the given domain.

See https://developer.dnsimple.com/v2/registrar/delegation/#delegateToVanity

func (*RegistrarService) CheckDomain

func (s *RegistrarService) CheckDomain(accountID string, domainName string) (*domainCheckResponse, error)

CheckDomain checks a domain name.

See https://developer.dnsimple.com/v2/registrar/#check

func (*RegistrarService) DisableDomainAutoRenewal

func (s *RegistrarService) DisableDomainAutoRenewal(accountID string, domainName string) (*domainResponse, error)

DisableDomainAutoRenewal disables auto-renewal for the domain.

See https://developer.dnsimple.com/v2/registrar/auto-renewal/#enable

func (*RegistrarService) DisableWhoisPrivacy

func (s *RegistrarService) DisableWhoisPrivacy(accountID string, domainName string) (*whoisPrivacyResponse, error)

DisablePrivacy disables the whois privacy for the domain.

See https://developer.dnsimple.com/v2/registrar/whois-privacy/#enable

func (*RegistrarService) EnableDomainAutoRenewal

func (s *RegistrarService) EnableDomainAutoRenewal(accountID string, domainName string) (*domainResponse, error)

EnableDomainAutoRenewal enables auto-renewal for the domain.

See https://developer.dnsimple.com/v2/registrar/auto-renewal/#enable

func (*RegistrarService) EnableWhoisPrivacy

func (s *RegistrarService) EnableWhoisPrivacy(accountID string, domainName string) (*whoisPrivacyResponse, error)

EnableWhoisPrivacy enables the whois privacy for the domain.

See https://developer.dnsimple.com/v2/registrar/whois-privacy/#enable

func (*RegistrarService) GetDomainDelegation

func (s *RegistrarService) GetDomainDelegation(accountID string, domainName string) (*delegationResponse, error)

GetDomainDelegation gets the current delegated name servers for the domain.

See https://developer.dnsimple.com/v2/registrar/delegation/#get

func (*RegistrarService) GetDomainPremiumPrice added in v0.14.0

func (s *RegistrarService) GetDomainPremiumPrice(accountID string, domainName string, options *DomainPremiumPriceOptions) (*domainPremiumPriceResponse, error)

Gets the premium price for a domain.

You must specify an action to get the price for. Valid actions are: - registration - transfer - renewal

See https://developer.dnsimple.com/v2/registrar/#premium-price

func (*RegistrarService) GetWhoisPrivacy

func (s *RegistrarService) GetWhoisPrivacy(accountID string, domainName string) (*whoisPrivacyResponse, error)

GetWhoisPrivacy gets the whois privacy for the domain.

See https://developer.dnsimple.com/v2/registrar/whois-privacy/#get

func (*RegistrarService) RegisterDomain

func (s *RegistrarService) RegisterDomain(accountID string, domainName string, request *DomainRegisterRequest) (*domainRegistrationResponse, error)

RegisterDomain registers a domain name.

See https://developer.dnsimple.com/v2/registrar/#register

func (*RegistrarService) RenewDomain

func (s *RegistrarService) RenewDomain(accountID string, domainName string, request *DomainRenewRequest) (*domainRenewalResponse, error)

RenewDomain renews a domain name.

See https://developer.dnsimple.com/v2/registrar/#register

func (*RegistrarService) TransferDomain

func (s *RegistrarService) TransferDomain(accountID string, domainName string, request *DomainTransferRequest) (*domainTransferResponse, error)

TransferDomain transfers a domain name.

See https://developer.dnsimple.com/v2/registrar/#transfer

func (*RegistrarService) TransferDomainOut

func (s *RegistrarService) TransferDomainOut(accountID string, domainName string) (*domainTransferOutResponse, error)

Transfer out a domain name.

See https://developer.dnsimple.com/v2/registrar/#transfer-out

type Response

type Response struct {
	// HTTP response
	HttpResponse *http.Response

	// If the response is paginated, the Pagination will store them.
	Pagination *Pagination `json:"pagination"`
}

A Response represents an API response.

func (*Response) RateLimit

func (r *Response) RateLimit() int

RateLimit returns the maximum amount of requests this account can send in an hour.

func (*Response) RateLimitRemaining

func (r *Response) RateLimitRemaining() int

RateLimitRemaining returns the remaining amount of requests this account can send within this hour window.

func (*Response) RateLimitReset

func (r *Response) RateLimitReset() time.Time

RateLimitReset returns when the throttling window will be reset for this account.

type Service added in v0.13.0

type Service struct {
	ID               int64            `json:"id,omitempty"`
	SID              string           `json:"sid,omitempty"`
	Name             string           `json:"name,omitempty"`
	Description      string           `json:"description,omitempty"`
	SetupDescription string           `json:"setup_description,omitempty"`
	RequiresSetup    bool             `json:"requires_setup,omitempty"`
	DefaultSubdomain string           `json:"default_subdomain,omitempty"`
	CreatedAt        string           `json:"created_at,omitempty"`
	UpdatedAt        string           `json:"updated_at,omitempty"`
	Settings         []ServiceSetting `json:"settings,omitempty"`
}

Service represents a Service in DNSimple.

type ServiceSetting added in v0.13.0

type ServiceSetting struct {
	Name        string `json:"name,omitempty"`
	Label       string `json:"label,omitempty"`
	Append      string `json:"append,omitempty"`
	Description string `json:"description,omitempty"`
	Example     string `json:"example,omitempty"`
	Password    bool   `json:"password,omitempty"`
}

ServiceSetting represents a single group of settings for a DNSimple Service.

type ServicesService added in v0.13.0

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

ServicesService handles communication with the service related methods of the DNSimple API.

See https://developer.dnsimple.com/v2/services/

func (*ServicesService) AppliedServices added in v0.13.0

func (s *ServicesService) AppliedServices(accountID string, domainIdentifier string, options *ListOptions) (*servicesResponse, error)

AppliedServices lists the applied one-click services for a domain.

See https://developer.dnsimple.com/v2/services/domains/#applied

func (*ServicesService) ApplyService added in v0.13.0

func (s *ServicesService) ApplyService(accountID string, serviceIdentifier string, domainIdentifier string, settings DomainServiceSettings) (*serviceResponse, error)

ApplyService applies a one-click services to a domain.

See https://developer.dnsimple.com/v2/services/domains/#apply

func (*ServicesService) GetService added in v0.13.0

func (s *ServicesService) GetService(serviceIdentifier string) (*serviceResponse, error)

GetService fetches a one-click service.

See https://developer.dnsimple.com/v2/services/#get

func (*ServicesService) ListServices added in v0.13.0

func (s *ServicesService) ListServices(options *ListOptions) (*servicesResponse, error)

ListServices lists the one-click services available in DNSimple.

See https://developer.dnsimple.com/v2/services/#list

func (*ServicesService) UnapplyService added in v0.13.0

func (s *ServicesService) UnapplyService(accountID string, serviceIdentifier string, domainIdentifier string) (*serviceResponse, error)

UnapplyService unapplies a one-click services from a domain.

See https://developer.dnsimple.com/v2/services/domains/#unapply

type Template

type Template struct {
	ID          int64  `json:"id,omitempty"`
	SID         string `json:"sid,omitempty"`
	AccountID   int64  `json:"account_id,omitempty"`
	Name        string `json:"name,omitempty"`
	Description string `json:"description,omitempty"`
	CreatedAt   string `json:"created_at,omitempty"`
	UpdatedAt   string `json:"updated_at,omitempty"`
}

Template represents a Template in DNSimple.

type TemplateRecord added in v0.13.0

type TemplateRecord struct {
	ID         int64  `json:"id,omitempty"`
	TemplateID int64  `json:"template_id,omitempty"`
	Name       string `json:"name"`
	Content    string `json:"content,omitempty"`
	TTL        int    `json:"ttl,omitempty"`
	Type       string `json:"type,omitempty"`
	Priority   int    `json:"priority,omitempty"`
	CreatedAt  string `json:"created_at,omitempty"`
	UpdatedAt  string `json:"updated_at,omitempty"`
}

TemplateRecord represents a DNS record for a template in DNSimple.

type TemplatesService

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

TemplatesService handles communication with the template related methods of the DNSimple API.

See https://developer.dnsimple.com/v2/templates/

func (*TemplatesService) ApplyTemplate added in v0.13.0

func (s *TemplatesService) ApplyTemplate(accountID string, templateIdentifier string, domainIdentifier string) (*templateResponse, error)

ApplyTemplate applies a template to the given domain.

See https://developer.dnsimple.com/v2/templates/domains/#apply

func (*TemplatesService) CreateTemplate

func (s *TemplatesService) CreateTemplate(accountID string, templateAttributes Template) (*templateResponse, error)

CreateTemplate creates a new template.

See https://developer.dnsimple.com/v2/templates/#create

func (*TemplatesService) CreateTemplateRecord added in v0.13.0

func (s *TemplatesService) CreateTemplateRecord(accountID string, templateIdentifier string, templateRecordAttributes TemplateRecord) (*templateRecordResponse, error)

CreateTemplateRecord creates a new template record.

See https://developer.dnsimple.com/v2/templates/records/#create

func (*TemplatesService) DeleteTemplate added in v0.13.0

func (s *TemplatesService) DeleteTemplate(accountID string, templateIdentifier string) (*templateResponse, error)

DeleteTemplate deletes a template.

See https://developer.dnsimple.com/v2/templates/#delete

func (*TemplatesService) DeleteTemplateRecord added in v0.13.0

func (s *TemplatesService) DeleteTemplateRecord(accountID string, templateIdentifier string, templateRecordID int64) (*templateRecordResponse, error)

DeleteTemplateRecord deletes a template record.

See https://developer.dnsimple.com/v2/templates/records/#delete

func (*TemplatesService) GetTemplate

func (s *TemplatesService) GetTemplate(accountID string, templateIdentifier string) (*templateResponse, error)

GetTemplate fetches a template.

See https://developer.dnsimple.com/v2/templates/#get

func (*TemplatesService) GetTemplateRecord added in v0.13.0

func (s *TemplatesService) GetTemplateRecord(accountID string, templateIdentifier string, templateRecordID int64) (*templateRecordResponse, error)

GetTemplateRecord fetches a template record.

See https://developer.dnsimple.com/v2/templates/records/#get

func (*TemplatesService) ListTemplateRecords added in v0.13.0

func (s *TemplatesService) ListTemplateRecords(accountID string, templateIdentifier string, options *ListOptions) (*templateRecordsResponse, error)

ListTemplateRecords list the templates for an account.

See https://developer.dnsimple.com/v2/templates/records/#list

func (*TemplatesService) ListTemplates

func (s *TemplatesService) ListTemplates(accountID string, options *ListOptions) (*templatesResponse, error)

ListTemplates list the templates for an account.

See https://developer.dnsimple.com/v2/templates/#list

func (*TemplatesService) UpdateTemplate added in v0.13.0

func (s *TemplatesService) UpdateTemplate(accountID string, templateIdentifier string, templateAttributes Template) (*templateResponse, error)

UpdateTemplate updates a template.

See https://developer.dnsimple.com/v2/templates/#update

type Tld

type Tld struct {
	Tld                 string `json:"tld"`
	TldType             int    `json:"tld_type"`
	WhoisPrivacy        bool   `json:"whois_privacy"`
	AutoRenewOnly       bool   `json:"auto_renew_only"`
	MinimumRegistration int    `json:"minimum_registration"`
	RegistrationEnabled bool   `json:"registration_enabled"`
	RenewalEnabled      bool   `json:"renewal_enabled"`
	TransferEnabled     bool   `json:"transfer_enabled"`
}

Tld represents a TLD in DNSimple.

type TldExtendedAttribute

type TldExtendedAttribute struct {
	Name        string                       `json:"name"`
	Description string                       `json:"description"`
	Required    bool                         `json:"required"`
	Options     []TldExtendedAttributeOption `json:"options"`
}

TldExtendedAttribute represents an extended attributes supported or required by a specific TLD.

See https://developer.dnsimple.com/v2/tlds/

type TldExtendedAttributeOption

type TldExtendedAttributeOption struct {
	Title       string `json:"title"`
	Value       string `json:"value"`
	Description string `json:"description"`
}

TldExtendedAttributeOption represents a single option you can assign to an extended attributes.

See https://developer.dnsimple.com/v2/tlds/

type TldsService

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

TldsService handles communication with the Tld related methods of the DNSimple API.

See https://developer.dnsimple.com/v2/tlds/

func (*TldsService) GetTld

func (s *TldsService) GetTld(tld string) (*tldResponse, error)

GetTld fetches a TLD.

See https://developer.dnsimple.com/v2/tlds/#get

func (*TldsService) GetTldExtendedAttributes

func (s *TldsService) GetTldExtendedAttributes(tld string) (*tldExtendedAttributesResponse, error)

GetTld fetches the extended attributes of a TLD.

See https://developer.dnsimple.com/v2/tlds/#get

func (*TldsService) ListTlds

func (s *TldsService) ListTlds(options *ListOptions) (*tldsResponse, error)

ListTlds lists the supported TLDs.

See https://developer.dnsimple.com/v2/tlds/#list

type User

type User struct {
	ID    int64  `json:"id,omitempty"`
	Email string `json:"email,omitempty"`
}

User represents a DNSimple user.

type VanityNameServer added in v0.13.0

type VanityNameServer struct {
	ID        int64  `json:"id,omitempty"`
	Name      string `json:"name,omitempty"`
	IPv4      string `json:"ipv4,omitempty"`
	IPv6      string `json:"ipv6,omitempty"`
	CreatedAt string `json:"created_at,omitempty"`
	UpdatedAt string `json:"updated_at,omitempty"`
}

VanityNameServer represents data for a single vanity name server

type VanityNameServersService added in v0.13.0

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

VanityNameServersService handles communication with Vanity Name Servers methods of the DNSimple API.

See https://developer.dnsimple.com/v2/vanity/

func (*VanityNameServersService) DisableVanityNameServers added in v0.13.0

func (s *VanityNameServersService) DisableVanityNameServers(accountID string, domainIdentifier string) (*vanityNameServerResponse, error)

DisableVanityNameServers Vanity Name Servers for the given domain

See https://developer.dnsimple.com/v2/vanity/#disable

func (*VanityNameServersService) EnableVanityNameServers added in v0.13.0

func (s *VanityNameServersService) EnableVanityNameServers(accountID string, domainIdentifier string) (*vanityNameServerResponse, error)

EnableVanityNameServers Vanity Name Servers for the given domain

See https://developer.dnsimple.com/v2/vanity/#enable

type Webhook

type Webhook struct {
	ID  int64  `json:"id,omitempty"`
	URL string `json:"url,omitempty"`
}

Webhook represents a DNSimple webhook.

type WebhooksService

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

WebhooksService handles communication with the webhook related methods of the DNSimple API.

See https://developer.dnsimple.com/v2/webhooks

func (*WebhooksService) CreateWebhook

func (s *WebhooksService) CreateWebhook(accountID string, webhookAttributes Webhook) (*webhookResponse, error)

CreateWebhook creates a new webhook.

See https://developer.dnsimple.com/v2/webhooks#create

func (*WebhooksService) DeleteWebhook

func (s *WebhooksService) DeleteWebhook(accountID string, webhookID int64) (*webhookResponse, error)

DeleteWebhook PERMANENTLY deletes a webhook from the account.

See https://developer.dnsimple.com/v2/webhooks#delete

func (*WebhooksService) GetWebhook

func (s *WebhooksService) GetWebhook(accountID string, webhookID int64) (*webhookResponse, error)

GetWebhook fetches a webhook.

See https://developer.dnsimple.com/v2/webhooks#get

func (*WebhooksService) ListWebhooks

func (s *WebhooksService) ListWebhooks(accountID string, _ *ListOptions) (*webhooksResponse, error)

ListWebhooks lists the webhooks for an account.

See https://developer.dnsimple.com/v2/webhooks#list

type WhoamiData

type WhoamiData struct {
	User    *User    `json:"user,omitempty"`
	Account *Account `json:"account,omitempty"`
}

WhoamiData represents an authenticated context that contains information about the current logged User and/or Account.

func Whoami

func Whoami(c *Client) (data *WhoamiData, err error)

Whoami is a state-less shortcut to client.Whoami() that returns only the relevant Data.

type WhoisPrivacy

type WhoisPrivacy struct {
	ID        int64  `json:"id,omitempty"`
	DomainID  int64  `json:"domain_id,omitempty"`
	Enabled   bool   `json:"enabled,omitempty"`
	ExpiresOn string `json:"expires_on,omitempty"`
	CreatedAt string `json:"created_at,omitempty"`
	UpdatedAt string `json:"updated_at,omitempty"`
}

WhoisPrivacy represents a whois privacy in DNSimple.

type Zone

type Zone struct {
	ID        int64  `json:"id,omitempty"`
	AccountID int64  `json:"account_id,omitempty"`
	Name      string `json:"name,omitempty"`
	Reverse   bool   `json:"reverse,omitempty"`
	CreatedAt string `json:"created_at,omitempty"`
	UpdatedAt string `json:"updated_at,omitempty"`
}

Zone represents a Zone in DNSimple.

type ZoneDistribution added in v0.21.0

type ZoneDistribution struct {
	Distributed bool `json:"distributed"`
}

ZoneDistribution is the result of the zone distribution check.

type ZoneFile added in v0.13.0

type ZoneFile struct {
	Zone string `json:"zone,omitempty"`
}

ZoneFile represents a Zone File in DNSimple.

type ZoneListOptions

type ZoneListOptions struct {
	// Select domains where the name contains given string.
	NameLike string `url:"name_like,omitempty"`

	ListOptions
}

ZoneListOptions specifies the optional parameters you can provide to customize the ZonesService.ListZones method.

type ZoneRecord

type ZoneRecord struct {
	ID           int64    `json:"id,omitempty"`
	ZoneID       string   `json:"zone_id,omitempty"`
	ParentID     int64    `json:"parent_id,omitempty"`
	Type         string   `json:"type,omitempty"`
	Name         string   `json:"name"`
	Content      string   `json:"content,omitempty"`
	TTL          int      `json:"ttl,omitempty"`
	Priority     int      `json:"priority,omitempty"`
	SystemRecord bool     `json:"system_record,omitempty"`
	Regions      []string `json:"regions,omitempty"`
	CreatedAt    string   `json:"created_at,omitempty"`
	UpdatedAt    string   `json:"updated_at,omitempty"`
}

ZoneRecord represents a DNS record in DNSimple.

type ZoneRecordListOptions

type ZoneRecordListOptions struct {
	// Select records where the name matches given string.
	Name string `url:"name,omitempty"`

	// Select records where the name contains given string.
	NameLike string `url:"name_like,omitempty"`

	// Select records of given type.
	// Eg. TXT, A, NS.
	Type string `url:"type,omitempty"`

	ListOptions
}

ZoneRecordListOptions specifies the optional parameters you can provide to customize the ZonesService.ListZoneRecords method.

type ZonesService

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

ZonesService handles communication with the zone related methods of the DNSimple API.

See https://developer.dnsimple.com/v2/zones/

func (*ZonesService) CheckZoneDistribution added in v0.21.0

func (s *ZonesService) CheckZoneDistribution(accountID string, zoneName string) (*zoneDistributionResponse, error)

CheckZoneDistribution checks if a zone is fully distributed across DNSimple nodes.

See https://developer.dnsimple.com/v2/zones/#checkZoneDistribution

func (*ZonesService) CheckZoneRecordDistribution added in v0.21.0

func (s *ZonesService) CheckZoneRecordDistribution(accountID string, zoneName string, recordID int64) (*zoneDistributionResponse, error)

CheckZoneRecordDistribution checks if a zone is fully distributed across DNSimple nodes.

See https://developer.dnsimple.com/v2/zones/#checkZoneRecordDistribution

func (*ZonesService) CreateRecord

func (s *ZonesService) CreateRecord(accountID string, zoneName string, recordAttributes ZoneRecord) (*zoneRecordResponse, error)

CreateRecord creates a zone record.

See https://developer.dnsimple.com/v2/zones/records/#createZoneRecord

func (*ZonesService) DeleteRecord

func (s *ZonesService) DeleteRecord(accountID string, zoneName string, recordID int64) (*zoneRecordResponse, error)

DeleteRecord PERMANENTLY deletes a zone record from the zone.

See https://developer.dnsimple.com/v2/zones/records/#deleteZoneRecord

func (*ZonesService) GetRecord

func (s *ZonesService) GetRecord(accountID string, zoneName string, recordID int64) (*zoneRecordResponse, error)

GetRecord fetches a zone record.

See https://developer.dnsimple.com/v2/zones/records/#getZoneRecord

func (*ZonesService) GetZone

func (s *ZonesService) GetZone(accountID string, zoneName string) (*zoneResponse, error)

GetZone fetches a zone.

See https://developer.dnsimple.com/v2/zones/#get

func (*ZonesService) GetZoneFile added in v0.13.0

func (s *ZonesService) GetZoneFile(accountID string, zoneName string) (*zoneFileResponse, error)

GetZoneFile fetches a zone file.

See https://developer.dnsimple.com/v2/zones/#get-file

func (*ZonesService) ListRecords

func (s *ZonesService) ListRecords(accountID string, zoneName string, options *ZoneRecordListOptions) (*zoneRecordsResponse, error)

ListRecords lists the zone records for a zone.

See https://developer.dnsimple.com/v2/zones/records/#listZoneRecords

func (*ZonesService) ListZones

func (s *ZonesService) ListZones(accountID string, options *ZoneListOptions) (*zonesResponse, error)

ListZones the zones for an account.

See https://developer.dnsimple.com/v2/zones/#list

func (*ZonesService) UpdateRecord

func (s *ZonesService) UpdateRecord(accountID string, zoneName string, recordID int64, recordAttributes ZoneRecord) (*zoneRecordResponse, error)

UpdateRecord updates a zone record.

See https://developer.dnsimple.com/v2/zones/records/#updateZoneRecord

Directories

Path Synopsis
Package webhook provides the support for reading and parsing the events sent from DNSimple via webhook.
Package webhook provides the support for reading and parsing the events sent from DNSimple via webhook.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL