This repository provides a Java example of how to download zone files via CZDS (Centralized Zone Data Service) REST API. A detail API Specs is included in this reposity in the docs directory.
There is also an example provided in Python. It can be found in this repo.
Language: Java 11
Build Tool: Maven 3.6+
You can provide default configurations in application.properties file.
# REST endpoint for authentication
# Can be overwritten via command line option -a
authentication.base.url=https://account-api.icann.org
# REST endpoint for downloading zone files
# Can be overwritten via command line option -c
czds.base.url=https://czds-api.icann.org
# Account credential.
# Optional. Can be overwritten via commandline option -u and -p
icann.account.username=username@example.com
icann.account.password=12345Abcd#
# The directory where zone files will be saved
# Optional. Default to current directory.
# Can be overwritten via commandline option -d
working.directory=/where/zonefiles/will/be/saved
Use command line -t to specify the TLDs you want to download zone files for. By default, all APPROVED zone files
will be downloaded. You can also use command line options to pass in your account credential and output directory.
The command line options have higher precedence than the application.properties file.
usage: ZoneFileDownloader [-a <arg>] [-c <arg>] [-h] [-o <arg>] [-p <arg>] [-t <arg>] [-u <arg>]
-a,--authen-url <arg> Specify the authentication REST endpoint base URL.
-c,--czds-url <arg> Specify the CZDS REST endpoint base URL.
-h,--help Print usage.
-d,--directory <arg> Specify the directory where the file(s) will be saved.
-p,--password <arg> Specify your password
-t,--tld <arg> Specify the TLD(s) you want to download zone file(s) for. Comma separated multiple TLDs.
By default, all APPROVED zone files will be downloaded.
-u,--username <arg> Specify your username.
mvn clean install
It produces an executable jar ./target/zonefile-downloader.jar
-
To download all of your APPROVED zone files assume that you have set all the required configurations in application.properties
- run
java -jar ./target/zonefile-downloader.jar -
To download zone files for one or more TLDs (for example, abb, booking), assume that you have set all the required configurations in application.properties
- run
java -jar ./target/zonefile-downloader.jar -t abb,booking -
To pass in all commandline options,
- run
java -jar ./target/zonefile-downloader.jar \
-a https://account-api.icann.org \
-c https://czds-api.icann.org \
-t booking \
-d /where/you/want/to/save/zonefiles \
-u username@example.com \
-p 1234567#Abcdefg
The org.icann.czd:czds-client library has been published in Maven Central Repository.
You can include the following artifact in your project:
<!-- https://mvnrepository.com/artifact/org.icann.czds/czds-client -->
<dependency>
<groupId>org.icann.czds</groupId>
<artifactId>czds-client</artifactId>
<version>1.x.x</version>
</dependency>
- CZDS REST API Specs - https://github.com/icann/czds-api-client/blob/master/docs/ICANN_CZDS_api.pdf
Contributions are welcome.
Reference Implementation in Python: https://github.com/icann/czds-api-client-python
Java: http://www.oracle.com/technetwork/java/javase/downloads/index.html
Apache Maven 3: https://maven.apache.org/download.cgi