Create Free Hostname
Hostname Restrictions for Creation
To ensure a safe, professional, and inclusive environment for all users, certain subdomain prefixes are restricted during the creation process. These restrictions are in place to:
- Maintain compliance with legal and ethical standards.
- Prevent the use of misleading, offensive, or harmful terms.
- Protect the reputation and functionality of our service.
Examples of Restricted Hostnames
- Explicit Content: Terms related to adult content (e.g., “porn,” “xxx”).
- Misleading Terms: Words that might impersonate official services (e.g., “admin,” “support”).
- Harmful or Offensive Language: Terms promoting hate speech, abuse, or violence.
Available Domains
You can create your hostname under any of the following domains:
- *.bindip.online
- *.bindip.live
- *.bindip.cloud
- *.bindip.xyz
For example, if you want to create a hostname called example, you can register it as:
- example.bindip.online
- example.bindip.live
- example.bindip.cloud
- example.bindip.xyz
Check If Your Desired Hostname Is Available
curl -X GET https://api.bindip.net/v1/subdomain/exists --url-query name=example.bindip.online --url-query key=<YOUR API KEY>
If the hostname is available, you will receive a response similar to:
{
"code": 404,
"name": "example.bindip.online",
"message": "NOT_FOUND"
}However, if the hostname is already registered by someone else, you will see a response like:
{
"code": 302,
"name": "example.bindip.online",
"message": "Found"
}Create Hostname
When creating your hostname, you have several options to suit your needs:
1. Automatically Assign Your Public IP
If your private service is already active and you create a hostname from the same IP address using the curl command, you can omit the
ip=<YOUR PUBLIC IP> parameter.
In this case, the system will automatically detect and assign your public IP address to your hostname. Your service or device will typically become active within minutes, often in under a minute based on our tests. curl -X POST https://api.bindip.net/v1/subdomain --url-query name=<YOUR HOSTNAME> --url-query key=<YOUR API KEY>
Also under the option that has the same result is to include the parameter as
ip=auto curl -X POST https://api.bindip.net/v1/subdomain --url-query name=<YOUR HOSTNAME> --url-query ip=auto --url-query key=<YOUR API KEY>
2. Reserve a Hostname Without an Active Service
If you don’t yet have an active service or device on your home network but want to reserve a specific hostname, you can use a placeholder value by setting the IP parameter to ip=0.0.0.0
curl -X POST https://api.bindip.net/v1/subdomain --url-query name=<YOUR HOSTNAME> --url-query ip=0.0.0.0 --url-query key=<YOUR API KEY>
3. Assign a Static or Known IP Address
If you have a static IP address or already know your public IP, you can define it directly using the parameter ip=<YOUR PUBLIC IP>.
curl -X POST https://api.bindip.net/v1/subdomain --url-query name=<YOUR HOSTNAME> --url-query ip=<YOUR PUBLIC IP> --url-query key=<YOUR API KEY>
4. Custom TTL (Time-To-Live)
When creating your hostname, you have the option to define a custom TTL value. By default, if you omit this parameter, a TTL of 60 seconds will be assigned to your hostname.
We recommend keeping the default TTL unless you have specific requirements and are experienced with DNS configurations.
If you wish to define a custom TTL, the curl request would look like the example shown below. Please note that the maximum TTL value allowed by our service is 86400 seconds (24 hours).
curl -X POST https://api.bindip.net/v1/subdomain --url-query name=<YOUR HOSTNAME> --url-query ip=<YOURPUBLIC IP> --url-query ttl=<YOUR TTL> --url-query key=<YOUR API KEY>