level23/dynadot-api

Implementation of the Dynadot API

v2.0.2 2023-10-18 11:28 UTC

This package is auto-updated.

Last update: 2024-10-18 13:36:46 UTC


README

Build Code Coverage Minimum PHP Version Packagist Version Total Downloads Quality Score Software License

Unofficial implementation for the advanced Dynadot domain API

Please note, this is a beta API implementation, based on the API description at https://www.dynadot.com/domain/api3.html

Before you can use this API you have to:

  • Get the API key from the dynadot backend
  • Whitelist the IP address where your requests are coming from

By default, we will try to connect to the Dynadoy API for 30 seconds. If that fails, an GuzzleHttp\Exception\ConnectException is thrown. You probably want to catch these in case if something goes wrong.

Only a limited set of features are currently implemented, and the exact methods and parameters available on this API may change in the future.

Installing

Install the latest version with:

$ composer require level23/dynadot-api

Requirements

To make use if this API you have to run PHP 8.2 or higher.

Contributing

If you want to help us improve this implementation, just contact us. All help is welcome! The only requirement for contributing is that all code is 100% covered by unit tests and that they implement the PSR standards.

License

See the file LICENSE for more information.

Example usage

See below some basic sample usages.

Getting Domain Details with getDomainInfo

<?php
use Level23\Dynadot\DynadotApi;

$apiKey = 'xxx YOUR API KEY xxx';

try {
    $api = new DynadotApi($apiKey);
    print_r($api->getDomainInfo('example.com'));
    
    // process your domain info here
} catch (Exception $e) {
    // ... handle exception
}

The returned object will be an instance of Level23\Dynadot\ResultObjects\DomainInfoResponses\Domain.

Example response:

Level23\Dynadot\ResultObjects\DomainResponse\Domain Object
(
    [Name] => example.com
    [Expiration] => 1514764799000
    [Registration] => 1291735572000
    [NameServerSettings] => Level23\Dynadot\ResultObjects\DomainResponse\NameServerSettings Object
        (
            [Type] => Name Servers
            [NameServers] => Array
                (
                    [0] => Array
                        (
                            [0] => Level23\Dynadot\ResultObjects\DomainResponse\NameServer Object
                                (
                                    [ServerId] => 1234
                                    [ServerName] => abc.org
                                )

                            [1] => Level23\Dynadot\ResultObjects\DomainResponse\NameServer Object
                                (
                                    [ServerId] => 12346
                                    [ServerName] => abc.com
                                )

                            [2] => Level23\Dynadot\ResultObjects\DomainResponse\NameServer Object
                                (
                                    [ServerId] => 1245
                                    [ServerName] => abc.co.uk
                                )

                            [3] => Level23\Dynadot\ResultObjects\DomainResponse\NameServer Object
                                (
                                    [ServerId] => 1267
                                    [ServerName] => abc.net
                                )

                        )

                )

            [WithAds] => false
        )

    [Whois] => Level23\Dynadot\ResultObjects\DomainResponse\Whois Object
        (
            [Registrant] => 1234
            [Admin] => 1234
            [Technical] => 1234
            [Billing] => 1234
        )

    [Locked] => true
    [Disabled] => false
    [UdrpLocked] => false
    [RegistrantUnverified] => false
    [Hold] => false
    [Privacy] => none
    [isForSale] => false
    [RenewOption] => auto-renew
    [Note] => 
    [Folder] => Level23\Dynadot\ResultObjects\DomainResponse\Folder Object
        (
            [FolderId] => 1234
            [FolderName] => Other
        )

)

The Whois container will return the contact id's for this specific domain. Full contact details can be fetched with this id by using the getContactInfo API call.

List all domains with getDomainList

<?php

use Level23\Dynadot\DynadotApi;

$apiKey = 'xxx YOUR API KEY xxx';


try {
    $api = new DynadotApi($apiKey);
    $list = $api->getDomainList();

    print_r( $list );
} catch (Exception $e) {
    // ... handle exception
}

This will return an array of Level23\Dynadot\ResultObjects\DomainInfoResponses\Domain objects. An exception will be thrown when anything went wrong.

Set nameservers for a domain with setNameserversForDomain

<?php

use Level23\Dynadot\DynadotApi;

$apiKey = 'xxx YOUR API KEY xxx';

try {
    $api = new DynadotApi($apiKey);
    $api->setNameserversForDomain('exmple.com', ['ns01.example.com', 'ns2.example.net', 'ns03.example.org']);
    // ...
} catch (Exception $e) {
    // ... handle exception
}

The setNameserversForDomain method will by default not give a response. An exception will be thrown when something went wrong.

Retrieving contact info with getContactInfo

<?php
use Level23\Dynadot\DynadotApi;

$apiKey = 'xxx YOUR API KEY xxx';

try {
    $api = new DynadotApi($apiKey);
    print_r($api->getContactInfo(1234)); // 1234 = the contact id, for example returned by the getDomainInfo call.
} catch (Exception $e) {
    echo $e->getMessage();
}

An exception will be thrown when something went wrong.

Example response:

Level23\Dynadot\ResultObjects\GetContactResponse\Contact Object
(
    [ContactId] => 12345
    [Organization] => org
    [Name] => name
    [Email] => example@example.com
    [PhoneCc] => 0
    [PhoneNum] => phone number
    [FaxCc] => example faxcc
    [FaxNum] => example faxnum
    [Address1] => address1
    [Address2] => address2
    [City] => city
    [State] => state
    [ZipCode] => zipcode
    [Country] => country
)

Set renew option with setRenewOption

<?php

use Level23\Dynadot\DynadotApi;

$apiKey = 'xxx YOUR API KEY xxx';

try {
    $api = new DynadotApi($apiKey);
    $api->setRenewOption('example.com', 'auto');
    // ...
} catch (Exception $e) {
    // ... handle exception
}

The setRenewOption let's you set the renewal setting for a domain. Values of for the second argument ($renewOption) van be "donot", "auto", "reset". The method will return true when the renew option is set successfully.

FAQ

I keep getting timeouts!

Make sure your IP address is whitelisted in the Dynadot backend. It can take a while (up to 1 hour) before the IP address is whitelisted.

I am banned from the Dynadot API!

The Dynadot API only allows 1 API call at the same time. Its not allowed to do concurrent API calls. If you do request multiple API calls at the same time you can be banned. The ban will be for 10 a 15 minutes.
Information received via dynadot chat