Module: RegApi2::Domain

Extended by:: Domain
Includes:: Builder
Included in:: Domain
Defined in:: lib/reg_api2/domain.rb

Overview

REG.API domain category

Instance Method Summary (collapse)

- (Object) accept_or_refuse_entering_list(opts = {})
Accept or decline domains transferred to this account.
- (Object) cancel_transfer(opts = {})
Use this function for cancelling domain transfers.
- (Object) check(opts = {})
This function serves to check availability of domains for registration.
- (Object) create(opts = {})
Apply for domain name registration.
- (Object) delegate(opts = {})
Use this this function to set the domain delegation flag.
- (Object) delete_ns(opts = {})
Deletion of a domain from the NSI registry (for international domains only).
- (Object) get_deleted(opts = {})
Get a list of deleted domains.
- (Object) get_docs_upload_uri(opts = {})
Use this function to get a hyperlink for uploading documents on .RU/.SU/.РФ domains.
- (Object) get_nss(opts = {})
You can use this function to get DNSs for domains.
- (Object) get_premium(opts = {})
Gets the list of available premium domain registration, the function works like the Reg.Premium service.
- (Hash(currency, price_group, prices)) get_prices(opts = {})
Get domain registration/renewal prices in all zones available.
- (Object) get_rereg_data(opts = {})
Use this function to get a list of “to be released” domains and their details.
- (Array<Hash(name, avail_in)>) get_suggest(opts = {})
Suggest a domain name using keywords.
- (Object) get_user_rereg_bids(opts = {})
Use this function to get the list with information about bids placed on them.
- (Object) look_at_entering_list(opts = {})
Use this function to view the list of domains transferred to this account.
- (NilClass or String) nop(opts = {})
For testing purposes.
- (Object) register_ns(opts = {})
Domain registration in the NSI registry (for internatonal domains only).
- (Object) request_to_transfer(opts = {})
Send request to domain transfer.
- (Object) set_rereg_bids(opts = {})
Use this function to place bids for “to be released” domains.
- (Object) transfer(opts = {})
With the help of this function you can apply for a transfer of a domain from another registrar.
- (Object) transfer_to_another_account(opts = {})
Full transfer of a domain to another account.
- (Object) undelegate(opts = {})
Use this flag to clear the domain delegation flag.
- (Object) update_contacts(opts = {})
With the help of this function you can make changes in the domain contact data.
- (Object) update_nss(opts = {})
Use this function to change DNS servers of the domain.
- (Object) update_private_person_flag(opts = {})
Use this function to change settings of the Private Person and Total Private Person flags (show/hide contact data in WHOIS).

Methods included from Builder

included

Instance Method Details

- (`Object`) accept_or_refuse_entering_list(opts = {})

Note:

Accessibility: partners.

Note:

Support of service lists: yes

Accept or decline domains transferred to this account.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

191	# File 'lib/reg_api2/domain.rb', line 191 define :accept_or_refuse_entering_list, field: :domains

- (`Object`) cancel_transfer(opts = {})

Note:

Accessibility: partners.

Note:

Support of service lists: yes

Use this function for cancelling domain transfers

Parameters:

opts (Hash) (defaults to: {}) —
Options.

198	# File 'lib/reg_api2/domain.rb', line 198 define :cancel_transfer

- (`Object`) check(opts = {})

Note:

Accessibility: partners

Note:

Support of service lists: yes

This function serves to check availability of domains for registration.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

72	# File 'lib/reg_api2/domain.rb', line 72 define :check, field: :domains

- (`Object`) create(opts = {})

Note:

Accessibility: clients

Note:

Support of service lists: For privileged clients only

Apply for domain name registration.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

79	# File 'lib/reg_api2/domain.rb', line 79 define :create

- (`Object`) delegate(opts = {})

Note:

Accessibility: partners.

Note:

Support of service lists: yes

Use this this function to set the domain delegation flag.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

163	# File 'lib/reg_api2/domain.rb', line 163 define :delegate

- (`Object`) delete_ns(opts = {})

Note:

Accessibility: everyone.

Note:

Support of service lists: no

Deletion of a domain from the NSI registry (for international domains only).

Parameters:

opts (Hash) (defaults to: {}) —
Options.

142	# File 'lib/reg_api2/domain.rb', line 142 define :delete_ns

- (`Object`) get_deleted(opts = {})

Note:

Accessibility: partners

Note:

Support of service lists: no

Get a list of deleted domains. The function is similar to the Deleted Domains page. Maximum returned elements in list equals to 50000.

Examples:

Typical usage

RegApi2.domain.get_deleted(
    tlds:         'ru',
    deleted_from: '2013-10-01',
    deleted_to:   '2013-11-01',
    min_pr:       2,
    min_cy:       1
)

Parameters:

opts (Hash) (defaults to: {}) —
Options.

65	# File 'lib/reg_api2/domain.rb', line 65 define :get_deleted, field: :domains

- (`Object`) get_docs_upload_uri(opts = {})

Note:

Accessibility: clients.

Note:

Support of service lists: no

Use this function to get a hyperlink for uploading documents on .RU/.SU/.РФ domains.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

114	# File 'lib/reg_api2/domain.rb', line 114 define :get_docs_upload_uri

- (`Object`) get_nss(opts = {})

Note:

Accessibility: clients.

Note:

Support of service lists: yes

You can use this function to get DNSs for domains.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

149	# File 'lib/reg_api2/domain.rb', line 149 define :get_nss

- (`Object`) get_premium(opts = {})

Note:

Accessibility: partners

Note:

Support of service lists: no

Gets the list of available premium domain registration, the function works like the Reg.Premium service

Parameters:

opts (Hash) (defaults to: {}) —
Options.

49	# File 'lib/reg_api2/domain.rb', line 49 define :get_premium, field: :domains

- (`Hash(currency, price_group, prices)`) get_prices(opts = {})

Note:

Accessibility: everyone

Note:

Support of service lists: no

Get domain registration/renewal prices in all zones available.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

Options Hash (opts):

:show_renew_data (Fixnum) —
With this flag enabled the System will return the price of registration renewal (1/0). Optional field.
:show_update_data (Fixnum) —
Флаг возврата цен для обновления домена (1/0). Необязательное поле.
:currency (String) —
Identifier of the currency in which the prices will be quoted: RUR (default), UAH, USD, EUR. Optional field.

Returns:

(Hash(currency, price_group, prices)) —
Prices sorted by domain zones. The prices are quoted for the period of 1 year. For some of the zones the minimum registration period exceeds 1 year. If a zone allows Cyrillic domains and the price for them differ from the price for domains in Latin characters, for such a zone the system will return an additional record with the prefix '__idn.'.

26	# File 'lib/reg_api2/domain.rb', line 26 define :get_prices

- (`Object`) get_rereg_data(opts = {})

Note:

Accessibility: clients

Note:

Support of service lists: no

Use this function to get a list of “to be released” domains and their details. The data is updated every 90 minutes.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

93	# File 'lib/reg_api2/domain.rb', line 93 define :get_rereg_data

- (`Array<Hash(name, avail_in)>`) get_suggest(opts = {})

Note:

Accessibility: partners

Note:

Support of service lists: no

Suggest a domain name using keywords. The function is similar to the Reg.Choice service.

Examples:

Suggest for house and new

RegApi2.domain.get_suggest word: 'house', additional_word: 'new', use_hyphen: false, tlds: [ :ru ]

Parameters:

opts (Hash) (defaults to: {}) —
Options.

Options Hash (opts):

:word (String) —
Main keyword. For example, «domain». Mandatory field.
:additional_word (String) —
Additional keyword. For example, «new» or «best». Optional field.
:category (String/Symbol) —
The category of picked up names. Valid values: pattern — names matching defined patterns («name + prefix»), search_trends – current search trends, all (default) – all categories.
:tlds (String/Array<String>) —
The zone in which the domain name should be checked for availability. Valid zones: ru, рф, su, com, net, org, biz, info. If a request does not contain a single tlds field, the domains will be searched in all the above-mentioned zones.
:use_hyphen (Boolean) —
Use hyphens to delimit words in domain names (for example, “best- domain”). Valid values: false (do not use hyphens) and true (use hyphens). By default hyphens are not used (“bestdomain”).
:use_plural (Boolean) —
Suggest plural forms for domain names. Valid values: false (do not suggest plural forms) and true (suggest plural forms). Optional field.

Returns:

(Array<Hash(name, avail_in)>) —
An array with domain name alternatives. Each element includes the field name (name alternative) and the array avail_in with a list of zones in which this name is available for registration. Maximum array size: 100.

42	# File 'lib/reg_api2/domain.rb', line 42 define :get_suggest, required: %w[ word ], field: :suggestions

- (`Object`) get_user_rereg_bids(opts = {})

Note:

Accessibility: clients.

Note:

Support of service lists: yes

Use this function to get the list with information about bids placed on them. The list also includes domains with overbids.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

107	# File 'lib/reg_api2/domain.rb', line 107 define :get_user_rereg_bids

- (`Object`) look_at_entering_list(opts = {})

Note:

Accessibility: partners.

Note:

Support of service lists: yes

Use this function to view the list of domains transferred to this account.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

184	# File 'lib/reg_api2/domain.rb', line 184 define :look_at_entering_list, field: :messages

- (`NilClass or String`) nop(opts = {})

For testing purposes. Also, with the help of this function you can check accessibility of a domain and get its ID. For this, pass username+password+dname.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

Options Hash (opts):

:dname (String) —
Domain name to check.

Returns:

(NilClass or String) —
nil or Domain identifier, available only when the domain name is passed in the field domain_name/dname.

15	# File 'lib/reg_api2/domain.rb', line 15 define :nop

- (`Object`) register_ns(opts = {})

Note:

Accessibility: everyone.

Note:

Support of service lists: no

Domain registration in the NSI registry (for internatonal domains only).

Parameters:

opts (Hash) (defaults to: {}) —
Options.

135	# File 'lib/reg_api2/domain.rb', line 135 define :register_ns

- (`Object`) request_to_transfer(opts = {})

Note:

Accessibility: partners.

Note:

Support of service lists: no

Send request to domain transfer.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

205	# File 'lib/reg_api2/domain.rb', line 205 define :request_to_transfer, field: :domains

- (`Object`) set_rereg_bids(opts = {})

Note:

Accessibility: clients. Partners can make an advance payment in the amount of 225 rub. and to pay the balance upon the successful fulfillment of the application for registration within 10 days of its execution (see the instalment parameter below). In case of choosing this payment procedure the domain will be registered, and after payment of the full amount it will be re-registered automatically on the specified data. In case of payment violation of the full amount by the due date, the pre-payment will be considered as firfeit and will not be refunded. See more information: Clauses 2.16, 2.17, 3.2.9, 6.11 of the agreement.

Note:

Support of service lists: yes

Use this function to place bids for “to be released” domains. Click here for details.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

100	# File 'lib/reg_api2/domain.rb', line 100 define :set_rereg_bids

- (`Object`) transfer(opts = {})

Note:

Accessibility: clients

Note:

Support of service lists: For privileged clients only

With the help of this function you can apply for a transfer of a domain from another registrar.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

86	# File 'lib/reg_api2/domain.rb', line 86 define :transfer

- (`Object`) transfer_to_another_account(opts = {})

Note:

Accessibility: partners.

Note:

Support of service lists: yes

Full transfer of a domain to another account.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

177	# File 'lib/reg_api2/domain.rb', line 177 define :transfer_to_another_account, field: :domains

- (`Object`) undelegate(opts = {})

Note:

Accessibility: partners.

Note:

Support of service lists: yes

Use this flag to clear the domain delegation flag.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

170	# File 'lib/reg_api2/domain.rb', line 170 define :undelegate

- (`Object`) update_contacts(opts = {})

Note:

Accessibility: clients.

Note:

Support of service lists: yes

With the help of this function you can make changes in the domain contact data.

Parameters:

opts (Hash) (defaults to: {}) —
Options.

121	# File 'lib/reg_api2/domain.rb', line 121 define :update_contacts

- (`Object`) update_nss(opts = {})

Note:

Accessibility: clients.

Note:

Support of service lists: yes

Use this function to change DNS servers of the domain. Also this function enables/disables domain delegation (for partners only).

Parameters:

opts (Hash) (defaults to: {}) —
Options.

156	# File 'lib/reg_api2/domain.rb', line 156 define :update_nss, field: :domains

- (`Object`) update_private_person_flag(opts = {})

Note:

Accessibility: clients.

Note:

Support of service lists: yes

Use this function to change settings of the Private Person and Total Private Person flags (show/hide contact data in WHOIS).

Parameters:

opts (Hash) (defaults to: {}) —
Options.

128	# File 'lib/reg_api2/domain.rb', line 128 define :update_private_person_flag

Module: RegApi2::Domain

Overview

Instance Method Summary (collapse)

Methods included from Builder

Instance Method Details

- (Object) accept_or_refuse_entering_list(opts = {})

- (Object) cancel_transfer(opts = {})

- (Object) check(opts = {})

- (Object) create(opts = {})

- (Object) delegate(opts = {})

- (Object) delete_ns(opts = {})

- (Object) get_deleted(opts = {})

- (Object) get_docs_upload_uri(opts = {})

- (Object) get_nss(opts = {})

- (Object) get_premium(opts = {})

- (Hash(currency, price_group, prices)) get_prices(opts = {})

- (Object) get_rereg_data(opts = {})

- (Array<Hash(name, avail_in)>) get_suggest(opts = {})

- (Object) get_user_rereg_bids(opts = {})

- (Object) look_at_entering_list(opts = {})

- (NilClass or String) nop(opts = {})

- (Object) register_ns(opts = {})

- (Object) request_to_transfer(opts = {})

- (Object) set_rereg_bids(opts = {})

- (Object) transfer(opts = {})

- (Object) transfer_to_another_account(opts = {})

- (Object) undelegate(opts = {})

- (Object) update_contacts(opts = {})

- (Object) update_nss(opts = {})

- (Object) update_private_person_flag(opts = {})

- (`Object`) accept_or_refuse_entering_list(opts = {})

- (`Object`) cancel_transfer(opts = {})

- (`Object`) check(opts = {})

- (`Object`) create(opts = {})

- (`Object`) delegate(opts = {})

- (`Object`) delete_ns(opts = {})

- (`Object`) get_deleted(opts = {})

- (`Object`) get_docs_upload_uri(opts = {})

- (`Object`) get_nss(opts = {})

- (`Object`) get_premium(opts = {})

- (`Hash(currency, price_group, prices)`) get_prices(opts = {})

- (`Object`) get_rereg_data(opts = {})

- (`Array<Hash(name, avail_in)>`) get_suggest(opts = {})

- (`Object`) get_user_rereg_bids(opts = {})

- (`Object`) look_at_entering_list(opts = {})

- (`NilClass or String`) nop(opts = {})

- (`Object`) register_ns(opts = {})

- (`Object`) request_to_transfer(opts = {})

- (`Object`) set_rereg_bids(opts = {})

- (`Object`) transfer(opts = {})

- (`Object`) transfer_to_another_account(opts = {})

- (`Object`) undelegate(opts = {})

- (`Object`) update_contacts(opts = {})

- (`Object`) update_nss(opts = {})

- (`Object`) update_private_person_flag(opts = {})