net3000.godaddy 1.0.0

Net3000.GoDaddy

Overview

The Net3000.GoDaddy library provides comprehensive integration with GoDaddy's API for Net3000 solutions. This library enables domain management, DNS configuration, hosting services, and domain-related operations using GoDaddy's domain and hosting platform.

Features

• Domain Management: Register, renew, and manage domain names
• DNS Configuration: Create and manage DNS records for domains
• Domain Information: Retrieve domain details and status information
• Hosting Services: Manage hosting accounts and services
• SSL Certificates: Handle SSL certificate management
• Domain Transfers: Manage domain transfer operations

Installation

dotnet add package net3000.godaddy

Dependencies

• Microsoft.Extensions.Configuration (v9.0.9)
• Newtonsoft.Json (v13.0.4)
• System.IdentityModel.Tokens.Jwt (v8.14.0)

Configuration

Add your GoDaddy API credentials to your configuration:

{
  "GoDaddy": {
    "ApiKey": "your-godaddy-api-key",
    "ApiSecret": "your-godaddy-api-secret",
    "BaseUrl": "https://api.godaddy.com/v1",
    "DefaultTtl": 3600
  }
}

Usage

Basic Setup

using net3000.goDaddy;

// Initialize the GoDaddy service
var goDaddyService = new GoDaddyService(configuration);

Domain Management

// Get domain information
var domainInfo = await goDaddyService.GetDomainAsync("example.com");

// Check domain availability
var availability = await goDaddyService.CheckDomainAvailabilityAsync("example.com");

// Get domain suggestions
var suggestions = await goDaddyService.GetDomainSuggestionsAsync("example");

// Renew domain
var renewResult = await goDaddyService.RenewDomainAsync(
    domain: "example.com",
    years: 1
);

DNS Management

// Get DNS records for domain
var dnsRecords = await goDaddyService.GetDnsRecordsAsync("example.com");

// Create DNS record
var createResult = await goDaddyService.CreateDnsRecordAsync(
    domain: "example.com",
    recordType: "A",
    name: "www",
    data: "192.168.1.1",
    ttl: 3600
);

// Update DNS record
var updateResult = await goDaddyService.UpdateDnsRecordAsync(
    domain: "example.com",
    recordType: "A",
    name: "www",
    data: "192.168.1.2"
);

// Delete DNS record
var deleteResult = await goDaddyService.DeleteDnsRecordAsync(
    domain: "example.com",
    recordType: "A",
    name: "www"
);

Hosting Services

// Get hosting account information
var hostingInfo = await goDaddyService.GetHostingAccountAsync("account-id");

// Get hosting plans
var hostingPlans = await goDaddyService.GetHostingPlansAsync();

// Manage SSL certificates
var sslCertificates = await goDaddyService.GetSslCertificatesAsync("example.com");

API Reference

GoDaddyService Class

Main service class for GoDaddy API integration.

Methods

• GetDomainAsync() - Get domain information
• CheckDomainAvailabilityAsync() - Check if domain is available
• GetDomainSuggestionsAsync() - Get domain name suggestions
• RenewDomainAsync() - Renew domain registration
• GetDnsRecordsAsync() - Get DNS records for domain
• CreateDnsRecordAsync() - Create new DNS record
• UpdateDnsRecordAsync() - Update existing DNS record
• DeleteDnsRecordAsync() - Delete DNS record
• GetHostingAccountAsync() - Get hosting account information
• GetHostingPlansAsync() - Get available hosting plans
• GetSslCertificatesAsync() - Get SSL certificates for domain

Models

• DomainInfo - Domain information data structure
• DnsRecord - DNS record configuration
• DomainAvailability - Domain availability status
• DomainSuggestion - Domain name suggestion
• HostingAccount - Hosting account information
• HostingPlan - Hosting plan details
• SslCertificate - SSL certificate information

Error Handling

Comprehensive error handling with detailed error messages from GoDaddy API. All methods include proper exception handling and return standardized response objects.

Rate Limiting

The library respects GoDaddy API rate limits and includes built-in retry logic for handling temporary rate limit exceeded responses.

Security Features

• API key authentication
• Secure credential storage
• Request signing and validation
• SSL/TLS encryption for all requests

DNS Record Types Supported

• A (IPv4 address)
• AAAA (IPv6 address)
• CNAME (Canonical name)
• MX (Mail exchange)
• TXT (Text record)
• NS (Name server)
• SOA (Start of authority)
• SRV (Service record)

Domain Operations

• Domain registration and renewal
• Domain transfer management
• WHOIS information retrieval
• Domain privacy protection
• Domain locking/unlocking

Testing

Use GoDaddy's sandbox environment for development:

• Sandbox API key and secret from GoDaddy Developer Portal
• Test domains for development purposes
• Sandbox endpoints for testing API calls

License

This library is proprietary to Net3000. Usage is restricted to Net3000.ca solutions and authorized affiliates. Redistribution, sublicensing, or integration with third-party products outside the Net3000 ecosystem is prohibited without written consent from Net3000.

Support

For support and questions, contact the Net3000 development team or visit net3000.ca.

Changelog

v1.0.0

• Initial release with GoDaddy API integration
• Domain management and DNS configuration
• Hosting services and SSL certificate management
• Comprehensive error handling and response management