ScarlettCode / dnsimple-csharp

A C# wrapper for the DNSimple REST API

A C# dynamic wrapper for the DNSimple REST API

DNSimple provides a simple HTTP-based API for working with DNS, domain registrations and SSL certificates. Learn more at developer.dnsimple.com.

• This SDK utilizes C# 4.0 dynamics to provide the quickest and most accurate representation of the DNSimple REST API. No models, no DTOs. Everything is an ExpandoObject or an Array of ExpandoObjects.
• See the Trello Board for API Parity Status

Current Release: v0.6.1 on NuGet

Installation

Via NuGet

Install REST API wrapper:

Install-Package DNSimple

Sample Usage

Retrieving a list of your DNSimple domains

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.ListDomains();
for (var i = 0; i < result.Length; i++)
{
	Console.WriteLine(result[i].domain.name);
}

Retrieving a specific domain

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.GetDomain("yourdomain.com");
Console.WriteLine(result.domain.name);

Adding a domain

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.AddDomain("yourdomain.com");
Console.WriteLine(result.domain.name);

Deleting a domain

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.DeleteDomain("yourdomain.com");

Check domain availability

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.CheckDomain("yourdomain.com");

Register a domain

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.RegisterDomain("yourdomain.com", registrant_id: an_existing_account_contact_id);

Transfer a domain to DNSimple

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.TransferDomain("yourdomain.com", registrant_id: an_existing_account_contact_id);

Renew a Domain

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.RenewDomain("yourdomain.com", renew_whois_privacy: false);

Set Nameservers for a Domain

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
// You can pass up to 6 nameservers
dynamic result = dns.SetNameServers("yourdomain.com", "n1.dnsimple.com", "n2.dnsimple.com", "ns3.dnsimple.com", "ns4.dnsimple.com");

Add a DNS Record for a Domain

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.AddRecord("yourdomain.com", name: "mail", record_type: "CNAME", content: "ghs.google.com");

Update a DNS Record for a Domain

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.UpdateRecord("yourdomain.com", record_id: an_existing_dns_record_id, name: "email", content: "ghs.google.com");

Delete a DNS Record for a Domain

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.DeleteRecord("yourdomain.com", record_id: an_existing_dns_record_id);

Retrieving a list of your DNSimple contacts

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.ListContacts();
for (var i = 0; i < result.Length; i++)
{
	Console.WriteLine(result[i].contact.last_name);
}

Retrieving a specific contact

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.GetContact(an_existing_contact_id);
Console.WriteLine(result.contact.last_name);

Add a Contact

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.AddContact("Jane", "Doe", "123 Ave B", "Miami", "FL", "12345", "US", "[e-mail]", "111 111 1111");

Update a Contact

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.UpdateContact(an_existing_contact_id, "John", "Doe", "1 SW 1st Street", "Miami", "FL", "33143", "US", "[e-mail]", "[phone]", label: "Home");

Delete a Contact

using DNSimple;
var dns = new DNSimpleRestClient("[e-mail]", "yourpassword");
dynamic result = dns.DeleteContact(an_existing_contact_id);