JarCastingCZDS API client in Java
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.
Environment
Language: Java 11
Build Tool: Maven 3.6+
Configurations
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
[email protected]
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
Command line Options
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.
Build
mvn clean install
It produces an executable jar ./target/zonefile-downloader.jar
Run
-
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 [email protected] \
-p 1234567#Abcdefg
Release
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>
Documentation
- CZDS REST API Specs - https://github.com/icann/czds-api-client/blob/master/docs/ICANN_CZDS_api.pdf
Contributing
Contributions are welcome.
Other
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
