README
¶
Go-Versio-API
The API for using the Versio ( http://www.versio.nl/ ) interface using the language Go. An account at Versio is required.
Usage
import (
"net/url"
"github.com/HuperWebs/versio"
)
One time, initialization
versio.Initialize("12345", "de9f2c7fd25e1b3afad3e85a0bd17d9b100db4b3", false)
Per query, either one of the following:
(a) Use 'raw' Send-function
// Prepare query data
data := url.Values{}
data.Set("command", "DomainsCheckAvailability")
data.Set("domain", "example")
data.Set("tld", "com")
// Actually making request
mapped, err := versio.Send(data)
if err != nil {
// error handling ...
}
// using mapped["success"] and others ...
(b) Use implemented command
mapped, err := versio.DomainsCheckAvailability("domain", "tld")
if err != nil {
// error handling .
}
// using mapped["success"] and others ...
Documentation
Documentation of the Golang implementation is available at https://godoc.org/github.com/HuperWebs/versio
Documentation of the Versio API is available in the PHP-version download at http://www.versio.nl/api.php
Documentation
¶
Overview ¶
Package versio allows access to the Versio-API. Download the PHP-vesion at http://www.versio.nl/api.php for API documentation.
Index ¶
- Constants
- func DNSTemplateAddRecord(template_id int, name string, rtype RecordType, value string, prio int, ...) (map[string]string, error)
- func DNSTemplatesAddRedirection(template_id int, from string, to url.URL) (map[string]string, error)
- func DNSTemplatesCreate(template_name string) (map[string]string, error)
- func DNSTemplatesDelete(template_id int) (map[string]string, error)
- func DNSTemplatesDeleteRecord(record_id int) (map[string]string, error)
- func DNSTemplatesDeleteRedirection(record_id int) (map[string]string, error)
- func DNSTemplatesList() (map[string]string, error)
- func DNSTemplatesListRecords(template_id int) (map[string]string, error)
- func DNSTemplatesListRedirections(template_id int) (map[string]string, error)
- func DomainsChangeCategory(domain, tld string, category_id int) (map[string]string, error)
- func DomainsChangeDNSTemplate(domain, tld string, template int) (map[string]string, error)
- func DomainsChangeOwner(domain, tld string, newcontact_id int, eppcode string) (map[string]string, error)
- func DomainsCheckAvailability(domain, tld string) (map[string]string, error)
- func DomainsCreateCategory(category_name string) (map[string]string, error)
- func DomainsCreateContact(...) (map[string]string, error)
- func DomainsDNSAddRecord(domain, tld, name string, recordType RecordType, value string, prio int, ...) (map[string]string, error)
- func DomainsDNSAddRedirection(domain, tld, from, to string) (map[string]string, error)
- func DomainsDNSAddRedirectionURL(domain, tld, from string, to url.URL) (map[string]string, error)
- func DomainsDNSDeleteRecord(domain, tld string, id int) (map[string]string, error)
- func DomainsDNSDeleteRedirection(domain, tld string, id int) (map[string]string, error)
- func DomainsDNSListRecords(domain, tld string) (map[string]string, error)
- func DomainsDNSListRedirections(domain, tld string) (map[string]string, error)
- func DomainsDNSOff(domain, tld string) (map[string]string, error)
- func DomainsDNSon(domain, tld string) (map[string]string, error)
- func DomainsDelete(domain, tld string) (map[string]string, error)
- func DomainsDeleteCategory(category_id int) (map[string]string, error)
- func DomainsDeleteContact(contact_id int) (map[string]string, error)
- func DomainsGetEPP(domain, tld string) (map[string]string, error)
- func DomainsGetToken(domain, tld string) (map[string]string, error)
- func DomainsListActive() (map[string]string, error)
- func DomainsListCategories() (map[string]string, error)
- func DomainsListContacts() (map[string]string, error)
- func DomainsListCountries() (map[string]string, error)
- func DomainsListInactive() (map[string]string, error)
- func DomainsListSingle(domain, tld string) (map[string]string, error)
- func DomainsListSingleContact(contact_id int) (map[string]string, error)
- func DomainsListTransferredAway() (map[string]string, error)
- func DomainsListTransfers() (map[string]string, error)
- func DomainsSendEPP(domain, tld string) (map[string]string, error)
- func DomainsSendEPP_be(domain, tld string) (map[string]string, error)
- func DomainsTLDInfo(tld string) (map[string]string, error)
- func Initialize(ClientNumber, ClientPassword string, SandboxMode bool)
- func Send(CommandParameters url.Values) (map[string]string, error)
- func SendWithChannel(CommandParameters url.Values, ch chan map[string]string)
- type RecordType
- type TTLValue
Constants ¶
const ( RecordTypeA RecordType = "A" RecordTypeAAAA RecordType = "AAAA" RecordTypeMX RecordType = "MX" RecordTypeCNAME RecordType = "CNAME" RecordTypePTR RecordType = "PTR" RecordTypeSRV RecordType = "SRV" RecordTypeTxt RecordType = "TXT" RecordTypeSPF RecordType = "SPF" TTLValue300 TTLValue = "300" TTLValue3600 TTLValue = "3600" TTLValue7200 TTLValue = "7200" TTLValue14400 TTLValue = "14400" TTLValue28800 TTLValue = "28800" TTLValue86400 TTLValue = "86400" )
Variables ¶
This section is empty.
Functions ¶
func DNSTemplateAddRecord ¶
func DNSTemplateAddRecord(template_id int, name string, rtype RecordType, value string, prio int, ttl TTLValue) (map[string]string, error)
DNSTemplateAddRecord adds a new DNS record for the given template. Any prio-value <= 0 will omit the optional prio-parameter.
func DNSTemplatesAddRedirection ¶
func DNSTemplatesAddRedirection(template_id int, from string, to url.URL) (map[string]string, error)
DNSTemplatesAddRedirection adds a new redirect-record for the given DNS template
func DNSTemplatesCreate ¶
DNSTemplatesCreate creates a new (empty) DNS template with given name
func DNSTemplatesDelete ¶
DNSTemplatesDelete removes a template from the list of templates.
func DNSTemplatesDeleteRecord ¶
DNSTemplatesDeleteRecord removes a DNS record from a DNS template, DNSListRecordsFromTemplate returns the required Record-ID.
func DNSTemplatesDeleteRedirection ¶
DNSTemplatesDeleteRedirection removes a DNS-redirect-record from a DNS template, DNSListRecordsFromTemplate returns the required Record-ID.
func DNSTemplatesList ¶
DNSTemplatesList returns a list of DNS templates
func DNSTemplatesListRecords ¶
DNSTemplatesListRecords returns the DNS records of a selected DNS template
func DNSTemplatesListRedirections ¶
DNSTemplatesListRedirections shows a list of DNS redirections of a selected DNS template
func DomainsChangeCategory ¶
DomainsChangeCategory removes a domain-category from the list
func DomainsChangeDNSTemplate ¶
DomainsChangeDNSTemplate changes the DNS template of the domain
func DomainsChangeOwner ¶
func DomainsChangeOwner(domain, tld string, newcontact_id int, eppcode string) (map[string]string, error)
DomainsChangeOwner changes the domain holder for a domain name. NOTE: this is not always free of charge! EPP-code is only for .BE domain-names.
func DomainsCheckAvailability ¶
DomainsCheckAvailability check whether or not the domain name is available. Limited usage: 100 + 8 * registered-domains.
func DomainsCreateCategory ¶
DomainsCreateCategory creates a new (empty) DNS category with the given name
func DomainsCreateContact ¶
func DomainsCreateContact(companyname, initials, surname, email, phone, street, hnr, hnradd, zipcode, city, country string) (map[string]string, error)
DomainsCreateContact adds a new contact. Optional parameters may be left empty (""), and other info available at API documentation.
func DomainsDNSAddRecord ¶
func DomainsDNSAddRecord(domain, tld, name string, recordType RecordType, value string, prio int, ttl TTLValue) (map[string]string, error)
DomainsDNSAddRecord adds a new DNS record for the domain. Any prio-value <= 0 will omit the optional prio-parameter.
func DomainsDNSAddRedirection ¶
DomainsDNSAddRedirection changes the DNS template of the domain, using a string as parameter value
func DomainsDNSAddRedirectionURL ¶
DomainsDNSAddRedirectionURL changes the DNS template of the domain, using a url.URL as parameter value
func DomainsDNSDeleteRecord ¶
DomainsDNSDeleteRecord deletes a DNS record for a domain
func DomainsDNSDeleteRedirection ¶
DomainsDNSDeleteRedirection changes the DNS template of the domain
func DomainsDNSListRecords ¶
DomainsDNSListRecords lists the DNS records for the domain
func DomainsDNSListRedirections ¶
DomainsDNSListRedirections returns a list of redirections for the domain
func DomainsDNSOff ¶
DomainsDNSOff turns off DNS administration for domain
func DomainsDNSon ¶
DomainsDNSon turns on DNS administration for domain
func DomainsDelete ¶
DomainsDelete deletes / declaims the domain name.
func DomainsDeleteCategory ¶
DomainsDeleteCategory removes a domain-category from the list
func DomainsDeleteContact ¶
DomainsDeleteContact deletes a single contact from the list
func DomainsGetEPP ¶
DomainsGetEPP returns the EPP token for .COM/NET?INFO/BIZ/ORG extensions. May be unavailable - in that case: use DomainsSendEPP.
func DomainsGetToken ¶
DomainsGetToken returns the transfer-token for a domain name (ONLY for .NL domain names)
func DomainsListActive ¶
DomainsListActive gives a list of active domain names, with expiration date, auto-renew setting and nameservers.
func DomainsListCategories ¶
DomainsListCategories returns a list of domain categories
func DomainsListContacts ¶
DomainsListContacts shows all contacts available
func DomainsListCountries ¶
DomainsListCountries lists the available countries along with country codes available.
func DomainsListInactive ¶
DomainsListInactive gives a list of inactive domain names, with expiration date, auto-renew setting and nameservers.
func DomainsListSingle ¶
DomainsListSingle gives information for one domain name, such as expiration date, auto-renew setting and nameservers.
func DomainsListSingleContact ¶
DomainsListSingleContact shows a single contact
func DomainsListTransferredAway ¶
DomainsListTransferredAway shows a list domains that were transferred in the past 30 days, including a timestamp of each transfer.
func DomainsListTransfers ¶
DomainsListTransfers shows a list of ongoing domain transfers, with information such as transfer status, text, and update time.
func DomainsSendEPP ¶
DomainsSendEPP sends the EPP-code for a .COM/NET/INFO/BIZ/ORG extension to the administrator of the domain (WHOIS). This domain does NOT have to be in your account to do this.
func DomainsSendEPP_be ¶
DomainsSendEPP_be sends the EPP-code for a .BE extension to the domain holder. This domain does NOT have to be in your account to do this.
func DomainsTLDInfo ¶
DomainsTLDInfo retrieves a list of available extensions (pricing included). If tld is nil, all extensions will be checked.
func Initialize ¶
Initialize sets the required variables (i.e. Password) for the Versio-API authentication. The password has to be SHA1-hashed already.
Types ¶
type RecordType ¶
type RecordType string
Source Files