Get Started

Quick Start with ddnames#

1. You can start by registering your account by sending a simple JSON request:

Route:http://136.244.82.142:8000/register/ JSON:

{
  "email":"YourEmail",
  "password":"password"
}

Don't forget to remember the API key, the system will generate it for you. 2. Get the bearer token by performing the login process by accessing the route: Route:

http://136.244.82.142:8000/login

Example of an answer:

{
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoyLCJleHAiOjE2NDMyNTIxNzR9.e4Kz-ruO2ohgu6kCKoceBroMCycd-yUAqBVGFN2jThs",
    "token_type": "bearer"
}
    <Callout>
    All further actions require the user data alongside with personalized bearer token in the header of the request!\
    Dont forget to attach the personalized token to each further request, otherwise, you will be non-authorized and be unable to perform actions.
    </Callout>
    3. Point your desired domain to our NS nameservers:
<http://fra.rastem.com.ua>
<http://tor.rastem.com.ua>
    4. Add your domain to ddnames database:
    Route:
<http://136.244.82.142:8000/add>
    JSON:
    ```json
    {
        "email":"YourEmail",
        "ipaddress":"your device's ip address",
        "apikey":"your api key",
        "domain":"yourdomain.com"
    }
the ipaddress should be IPv4: `xx.xx.xx.xx`
5\. Update your domain IP address(check the [scripts](/scripts "ddnames scripts for dynamic IP update") for automatic IP address update):
Route: `http://136.244.82.142:8000/update`
JSON:
```json
{
    "email":"yourEmail",
    "apikey":"yourApikey",
    "domain":"yourDomain",
    "ipaddress":"device IP address"
}

6. Check your account and domains:

Route:http://136.244.82.142:8000/check JSON:

{
    "email": "yourEmail",
    "apikey": "yourAPIKey"
}

Typical answer:

{
    "status": "200 OK. Domains Checked",
    "email": "bro_dev_dominating@twitter.com",
    "apikey": "Yr15oqCRaDN",
    "account_type": "Trial",
    "domains_added": 1,
    "domains_names_limit": 3,
    "requests_made": 8,
    "requests_left": 2092,
    "requests_limit": 2100,
    "requests_updated_at": "2022-01-19",
    "created_at": "2021-12-22",
    "domains_remain": [
        {
            "domain": "bigmoneyprojects.com",
            "ipaddress": "101.41.1.122",
            "requests_made": 1,
            "created_at": "2021-12-22",
            "updated_at": "2021-12-22"
        }
    ]
}

7. Delete a domain from your account:

Route: JSON:

{
"email":"yourEmail",
"apikey":"yourAPIKey",
"domain_removed":"yourDomain"
}