Default

Check availability and prices for multiple domains

post

Принимает JSON { "domains": ["example.com"] }. Возвращает статус и цену по каждому домену.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

domainsstring[]Required

Список доменов для проверки (минимум 1, максимум 100)

Responses

200

Результаты проверки по каждому домену

application/json

successbooleanOptional

totalintegerOptional

Количество результатов (== length of results)

400

Неверный запрос

application/json

post

/api/v1/info

HTTPcURLJavaScriptPython

POST /api/v1/info HTTP/1.1
Host: api.eternity.domains
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "domains": [
    "example.com",
    "site.io"
  ]
}

{
  "results": [
    {
      "domain": "example.com",
      "status": "available",
      "code": 0,
      "price": 9.99
    },
    {
      "domain": "taken.com",
      "status": "registered",
      "code": 0,
      "price": 0
    }
  ],
  "success": true,
  "total": 2
}

Get DNS records for a domain

get

Требуется тело запроса { "domain": "example.com" }. Проверяется Authorization Bearer token. Если домен подключён к Cloudflare — возвращаются CF-записи (включая поле proxy). Если включён EDNS провайдера — возвращаются записи формата EDNS (включая поле priority для MX/SRV).

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

domainstringRequired

Домен в формате example.com

Responses

200

Список DNS записей (Cloudflare или EDNS)

application/json

codeintegerOptional

400

Bad request — domain missing or invalid

application/json

401

Unauthorized — API key not found or missing Authorization header

application/json

500

Internal server error while fetching DNS records

application/json

get

/api/v1/dns

HTTPcURLJavaScriptPython

GET /api/v1/dns HTTP/1.1
Host: api.eternity.domains
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "domain": "example.com"
}

{
  "records": [
    {
      "id": "rec_1",
      "type": "A",
      "name": "@",
      "content": "192.0.2.1",
      "proxy": false
    },
    {
      "id": "rec_2",
      "type": "CNAME",
      "name": "www",
      "content": "example.com",
      "proxy": true
    }
  ],
  "code": 0
}

Add DNS record (Cloudflare or EDNS)

post

Добавляет DNS запись. Валидация IP для A/AAAA выполняется на стороне сервера.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

domainstringRequired

subdomainstringRequired

Имя записи, например 'www' или '@'

contentstringRequired

IP для A/AAAA или значение для CNAME/TXT

typestringRequired

Тип записи: A, AAAA, CNAME, TXT, MX и т.п.

Responses

200

Запись добавлена

application/json

messagestringOptional

Человеко-читаемое сообщение

successbooleanOptional

Флаг успеха

codeintegerOptional

Код операции, 0 — ok

400

Ошибка валидации

application/json

post

/api/v1/addrecord

HTTPcURLJavaScriptPython

POST /api/v1/addrecord HTTP/1.1
Host: api.eternity.domains
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 75

{
  "domain": "example.com",
  "subdomain": "www",
  "content": "192.0.2.1",
  "type": "A"
}

{
  "message": "Record added",
  "success": true,
  "code": 0
}

Enable Cloudflare for a domain

put

Запускает процесс подключения Cloudflare: создаёт зону и обновляет флаги в БД. Если домен уже зарегистрирован — будет использована текущая регистрационная информация.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

domainstringRequired

Домен в формате example.com

Responses

200

Cloudflare queued

application/json

messagestringOptional

Человеко-читаемое сообщение

successbooleanOptional

Флаг успеха

codeintegerOptional

Код операции, 0 — ok

404

Domain not found

application/json

put

/api/v1/enablecf

HTTPcURLJavaScriptPython

PUT /api/v1/enablecf HTTP/1.1
Host: api.eternity.domains
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "domain": "example.com"
}

{
  "message": "Cloudflare enable queued",
  "success": true,
  "code": 0
}

Disable Cloudflare for a domain

put

Отключает Cloudflare: возвращает неймсерверы регистратора и очищает CF-конфигурацию.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

domainstringRequired

Домен в формате example.com

Responses

200

Cloudflare disabled

application/json

messagestringOptional

Человеко-читаемое сообщение

successbooleanOptional

Флаг успеха

codeintegerOptional

Код операции, 0 — ok

404

Domain not found

application/json

put

/api/v1/disablecf

HTTPcURLJavaScriptPython

PUT /api/v1/disablecf HTTP/1.1
Host: api.eternity.domains
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "domain": "example.com"
}

{
  "message": "Cloudflare disabled",
  "success": true,
  "code": 0
}

Get domain registry info (expire, status)

get

Возвращает состояние домена в реестре. Тело запроса { "domain": "example.com" }.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

domainstringRequired

Домен в формате example.com

Responses

200

Domain info

application/json

domainstringOptional

expireintegerOptional

Unix ms — время окончания регистрации

statusstringOptional

ok | pending | error

codeintegerOptional

404

Domain not found

application/json

get

/api/v1/domain

HTTPcURLJavaScriptPython

GET /api/v1/domain HTTP/1.1
Host: api.eternity.domains
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "domain": "example.com"
}

{
  "domain": "example.com",
  "expire": 1788777591195,
  "status": "ok",
  "code": 0
}

Register a domain

post

Обычная регистрация домена.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

domainstringRequired

Домен в формате example.com

Responses

200

Registered

application/json

messagestringOptional

Человеко-читаемое сообщение

successbooleanOptional

Флаг успеха

codeintegerOptional

Код операции, 0 — ok

402

Insufficient balance

application/json

406

Domain already registered

application/json

post

/api/v1/register

HTTPcURLJavaScriptPython

POST /api/v1/register HTTP/1.1
Host: api.eternity.domains
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "domain": "example.com"
}

{
  "message": "Domain registered",
  "success": true,
  "code": 0
}

Register a domain and enable Cloudflare immediately

post

Регистрирует и одновременно создаёт Cloudflare-зону; используется, если нужно сразу зарегестрировать домен с Cloudflare.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

domainstringRequired

Домен в формате example.com

Responses

200

Registered + CF enabled

application/json

messagestringOptional

Человеко-читаемое сообщение

successbooleanOptional

Флаг успеха

codeintegerOptional

Код операции, 0 — ok

400

Validation error

application/json

post

/api/v1/registerwithcf

HTTPcURLJavaScriptPython

POST /api/v1/registerwithcf HTTP/1.1
Host: api.eternity.domains
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "domain": "example.com"
}

{
  "message": "Operation completed",
  "success": true,
  "code": 0
}

Register a domain and set to provider's DNS (EDNS)

post

Регистрирует домен и включает EDNS провайдера

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

domainstringRequired

Домен в формате example.com

Responses

200

Registered + EDNS enabled

application/json

messagestringOptional

Человеко-читаемое сообщение

successbooleanOptional

Флаг успеха

codeintegerOptional

Код операции, 0 — ok

400

Validation error

application/json

post

/api/v1/registerwithdns

HTTPcURLJavaScriptPython

POST /api/v1/registerwithdns HTTP/1.1
Host: api.eternity.domains
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "domain": "example.com"
}

{
  "message": "Operation completed",
  "success": true,
  "code": 0
}

List domains owned by API key

get

Возвращает список доменов, связанных с переданным в Authorization ключом API.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Array of domain objects

application/json

idstringOptional

domainstringOptional

cf_enabledbooleanOptional

Cloudflare enabled flag

creation_timeintegerOptional

Unix ms — время создания

red_trustbooleanOptional

Внутренний флаг доверия

401

Unauthorized

application/json

get

/api/v1/domains

HTTPcURLJavaScriptPython

GET /api/v1/domains HTTP/1.1
Host: api.eternity.domains
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "1",
    "domain": "example.com",
    "cf_enabled": true,
    "creation_time": 1670000000000,
    "red_trust": false
  }
]

Get balance

get

Возвращает баланс в долларах

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Balance

application/json

balancenumber · floatOptional

Баланс в USD

401

Unauthorized

application/json

get

/api/v1/balance

HTTPcURLJavaScriptPython

GET /api/v1/balance HTTP/1.1
Host: api.eternity.domains
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "balance": 42.5
}

Get domain nameservers (from registrar)

get

Требуется тело { "domain": "example.com" }. Возвращает массив неймсерверов.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

domainstringRequired

Домен в формате example.com

Responses

200

Nameservers

application/json

nsstring[]Optional

codeintegerOptional

get

/api/v1/nameservers

HTTPcURLJavaScriptPython

GET /api/v1/nameservers HTTP/1.1
Host: api.eternity.domains
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "domain": "example.com"
}

200

Nameservers

{
  "ns": [
    "ns1.registrar.example",
    "ns2.registrar.example"
  ],
  "code": 0
}

Patch nameservers for domain

patch

Обновляет неймсерверы домена. Если домен был подключён к Cloudflare — CF настройки удаляются.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

domainstringRequired

ns0stringRequired

ns1stringRequired

Responses

200

Nameservers updated

application/json

messagestringOptional

Человеко-читаемое сообщение

successbooleanOptional

Флаг успеха

codeintegerOptional

Код операции, 0 — ok

400

Bad request

application/json

patch

/api/v1/nameservers

HTTPcURLJavaScriptPython

PATCH /api/v1/nameservers HTTP/1.1
Host: api.eternity.domains
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 72

{
  "domain": "example.com",
  "ns0": "ns1.example.net",
  "ns1": "ns2.example.net"
}

{
  "message": "Operation completed",
  "success": true,
  "code": 0
}

Delete domain from system

delete

Удаление домена.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

domainstringRequired

Responses

200

Deleted

application/json

messagestringOptional

Человеко-читаемое сообщение

successbooleanOptional

Флаг успеха

codeintegerOptional

Код операции, 0 — ok

404

Domain not found

application/json

delete

/api/v1/delete

HTTPcURLJavaScriptPython

DELETE /api/v1/delete HTTP/1.1
Host: api.eternity.domains
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "domain": "example.com"
}

{
  "message": "Operation completed",
  "success": true,
  "code": 0
}