https://github.com/juandiii/namecom-api

Unofficial Name.com API V4 Support Java 11 and above
https://github.com/juandiii/namecom-api

domain hacktoberfest hacktoberfest2021 java java11 java17 name namecom nameserver reseller resellers restful-api

Last synced: 5 days ago
JSON representation

Unofficial Name.com API V4 Support Java 11 and above

• Host: GitHub
• URL: https://github.com/juandiii/namecom-api
• Owner: juandiii
• License: mit
• Created: 2021-09-20T17:20:25.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2022-12-16T02:12:01.000Z (almost 2 years ago)
• Last Synced: 2024-09-25T20:50:43.364Z (8 days ago)
• Topics: domain, hacktoberfest, hacktoberfest2021, java, java11, java17, name, namecom, nameserver, reseller, resellers, restful-api
• Language: Java
• Homepage:
• Size: 41 KB
• Stars: 6
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 🌎 Name.com Library

![Supported Java 11 and above](https://img.shields.io/badge/JVM-11--17-brightgreen?logo=Java)

![GitHub Workflow Status]()

Unofficial [**Name.com**](https://name.com) library for Java is an API V4 Rest is accessed over HTTPS. You can use to consuming resources through API [**Name.com**](https://name.com)

This is used by the library HTTP client also known as [**Resteasy**](https://github.com/resteasy/resteasy)

# ⚙️ Configuration

You need to set configuration the properties `username`, `token` and set them properly. Name.com gives your credentials.

| Key            | Description                 | Required  |

|----------------|-----------------------------|-----------|

| username       | Username of Name.com        | ✅        |

| token          | Secret token of Name.com    | ✅        |

# 📄 Example

We have two options for synchronous and asynchronous for some application you can use imperative programming or reactive programming. In my case I do to set reactive programming with Smallrye Mutiny with the framework Quarkus

## 👨🏻‍💻 Example usage (Sync)

```java

// Get an instance

Name client = Name.getInstance("username", "token-123");

// Consuming an endpoint

// Get all domains

ListDomain domains = client.domains().getDomains();

```

## 👨🏻‍💻 Example usage (asynchronous)

```java

// Get an instance asynchronous

NameAsync name = NameAsync.getInstance("username", "token-123");

// Get List domain in asynchronous

CompletionStage domains = name.async().getDomains();

domains.whenComplete((listDomain, throwable) -> {

  listDomain.getDomains().forEach(domain -> System.out.println(domain.getDomainName()));

});

```

# 😇 Contribution

To be honest