API de Domínios

Dropcatch domains and manage your account with Dynadot's Domain API! Our Domain API allows you to search for, register, renew, and delete domain names programmatically, using your own software and servers. With our Domain API, you can also easily set name servers, renew options, and folders for your domains. Our Domain API is available to all accounts, so get started today!

Want more features? Check out our Advanced Domain API!

Comece a Usar nossa API de Domínios

Requests to our Domain API are sent to the following URL:

https://api.dynadot.com/api2.html

Note que as solicitações devem ser enviadas por https (soquete seguro) por segurança. Apenas 1 solicitação pode ser processada por vez. Por favor, aguarde o término da solicitação atual antes de enviar outra. A solicitação deve ter os seguintes parâmetros:

Parâmetro de Solicitação
Explicação
keySua chave para acessar a API, disponível no seu painel de controle.
commandOs comandos suportados agora são "search" e "register"

Os resultados são enviados como um arquivo de texto delimitado por vírgulas. A primeira linhas traz o resultado do comando. Essa linhas tem 2 campos.

Campo de Resultado
Explicação
1The result of this API call:
ok - the command was successful
error - the command was not successful
2Mais informações sobre o resultado, usado somente quando o resultado é um "erro"

A segunda linha está vazia. As linhas subsequentes são resultados do comando, como, por exemplo, os resultados da pesquisa.

Comando de Pesquisa

Se chamar o comando de pesquisa, os seguintes parâmetros devem ser incluídos:

Parâmetro de Solicitação de Pesquisa
Explicação
domain0 - domain99The domain name you are searching for, regular account can specify 1 domain per command, bulk and super bulk account can specify up to 100 domains
language0 - language99 (opcional)O marcador de idioma do domínio respectivo, apenas para IDNs
show_price (opcional)Se quiser mostrar o preço na moeda da sua conta, defina como "1".

Haverá 1 linha de resultado para cada domínio enviado. Cada linha terá 5 campos.

Campo de Resultado de Pesquisa
Explicação
1O parâmetro do domínio, por exemplo: domain0
2O nome de domínio pesquisado, por exemplo: mydomain.com
3O idioma, caso algum, por exemplo: spa
4The result of the search:
yes - the domain is available
no - the domain is not available
offline - the central registry for this domain is currently offline
system_busy - all connections are busy
error - there was a syntax or registry error processing this domain
5Mais informações sobre o preço/resultado, usado apenas quando o resultado é um "erro" ou quando "show_price" é definido como "1" na solicitação

Exemplo de Pesquisa

Solicitação

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1

Resposta

ok, domain0,mydomain.com,,no, domain1,mydomain.net,,yes,10.99 in USD

Comando de Registro

Chamar o comando de registro irá criar e processar um pedido de registo. Você deve ter saldo suficiente na conta para pagar pela compra. Ao chamar o comando de registo, os seguintes parâmetros devem ser incluídos:

Parâmetro de Solicitação de Registro
Explicação
domainO nome de domínio que você deseja registrar, apenas 1 domínio pode ser registrado por solicitação
languageO marcador de idioma do domínio solicitado. Necessário apenas quando o domínio é um IDN
durationPor quantos anos deseja registrar o domínio
option0 (se necessário)O nome do registrante de .BE
option1 (se necessário)O nome da organização registrante de .BE (opcional)
premium (opcional)If you want to regist a premium domin, set it equal to "1" (optional)

Haverá 1 linha de resultado para cada solicitação enviada. Cada linha terá 3 campos.

Campo de Resultado de Registro
Explicação
1The result of the register request:
success - the domain was successfully registered
not_available - the domain is not available
insufficient_funds - not enough account balance to process this registration
offline - the central registry for this domain is currently offline
system_busy - all connections are busy
error - there was a syntax or registry error processing this request
2Mais informações sobre o resultado, usado somente quando o resultado é um "erro"
3Data de expiração no tempo unix (milissegundos desde meia-noite UTC de 1 janeiro de 1970), usado apenas quando o resultado é "bem-sucedido"

Exemplo de Registro

Solicitação

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=register&domain=mydomain.com&duration=1

Resposta

ok, success,,1180897681932

Comando de Exclusão

Calling the delete command will delete a domain that is still in the grace period. Your account balance will be credited back the registration fee minus any deletion fees (see our grace deletion page for more info). Domains that have been renewed, or that have been moved to a new account cannot be deleted through the API. If calling the delete command, the following parameters should be included:

Parâmetro da Solicitação de Exclusão
Explicação
domainO nome de domínio que você deseja excluir, apenas 1 domínio pode ser excluído por solicitação

Haverá 1 linha de resultado para cada solicitação enviada. Cada linha terá 2 campos.

Campo do Resultado de Exclusão
Explicação
1The result of the delete request:
success - the domain was successfully deleted
grace_expired - the grace period has already expired
too_soon - cannot delete a domain the first hour after registration
offline - the central registry for this domain is currently offline
error - there was a syntax or registry error processing this requesterror - there was a syntax or registry error processing this request
2Mais informações sobre o resultado, usado somente quando o resultado é um "erro"

Exemplo de Exclusão

Solicitação

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=delete&domain=mydomain.com

Resposta

ok, success,

Comando de Renovação

Calling the renew command will create and process a renewal order. You must have enough account balance to pay for the order. If calling the renew command, the following parameters should be included:

Parâmetro de Solicitação de Renovação
Explicação
domainO nome de domínio que você deseja renovar, somente 1 domínio pode ser renovado por solicitação
durationPor quantos anos renovar o domínio
year (opcional)O ano atual no qual o domínio expira

Haverá 1 linha de resultado para cada solicitação enviada. Cada linha terá 3 campos.

Parâmetro de Solicitação de Renovação
Explicação
1The result of the renew request:
success - the domain was successfully renewed
insufficient_funds - not enough account balance to process this renewal
offline - the central registry for this domain is currently offline
error - there was a syntax or registry error processing this request
2Mais informações sobre o resultado, usado somente quando o resultado é um "erro"
3Data de expiração no tempo unix (milissegundos desde meia-noite UTC de 1 janeiro de 1970), usado apenas quando o resultado é "bem-sucedido"

Exemplo de Renovação

Solicitação

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=renew&domain=mydomain.com&duration=1

Resposta

ok, success,,1180897681932

Comando de Obtenção de Servidores de Nomes

Ao chamar o comando de obtenção de servidores de nomes, os seguintes parâmetros devem ser incluídos:

Parâmetro de Solicitação de Obtenção de Servidores de Nomes
Explicação
domainO domínio cujas informações de servidor de nome se deseja obter, apenas as informações de servidor de nomes de 1 domínio podem ser recebidas por solicitação.

Haverá 1 linha de resultado para cada solicitação enviada. Cada linha terá 2 campos.

Campo de Resultado de Obtenção de Servidores de Nomes
Explicação
1The result of the get name servers request:
success - the name servers were successfully returned
offline - the central registry for this domain is currently offline
error - there was a syntax or registry error processing this request
2As informações detalhadas dos servidores de nome (ns0 - ns12) ou mais informações sobre o resultado caso este seja um "erro"
3Mais informações sobre as configurações do servidor de nomes, usado apenas quando o resultado é "bem-sucedido"

Exemplo de Obtenção de Servidores de Nomes

Solicitação

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=get_ns&domain=mydomain.com

Resposta

ok, success,ns1.dynadot.com,ns2.dynadot.com,,,,,,,,,,,,Dynadot Forwarding

Comando de Definição de Servidores de Nomes

Ao chamar o comando de definição de servidores de nomes, os seguintes parâmetros devem ser incluídos:

Parâmetro de Solicitação de Definição de Servidores de Nomes
Explicação
domainO nome de domínio a ser atualizado, apenas 1 domínio pode ser definido por solicitação
ns0 - ns12Os servidores de nomes para configurar seu domínio para uso, você pode especificar até 13 servidores de nomes, mas eles já devem estar na sua conta.

Haverá 1 linha de resultado para cada solicitação enviada. Cada linha terá 2 campos.

Campo de resultado da definição dos servidores de nomes
Explicação
1The result of the set name servers request:
success - the name servers were successfully set
offline - the central registry for this domain is currently offline
error - there was a syntax or registry error processing this request
2Mais informações sobre o resultado, usado somente quando o resultado é um "erro"

Exemplo de Definição de Servidores de Nomes

Solicitação

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=set_ns&domain=mydomain.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com

Resposta

ok, success,

Comando de Definição das Opções de Renovação

Ao chamar o comando de definição das opções de renovação, os seguintes parâmetros devem ser incluídos:

Parâmetro da Solicitação de Definição das Opções de Renovação
Explicação
domainO nome de domínio a ser atualizado, apenas 1 domínio pode ser definido por solicitação
renew-optionreset - reset the domain's renew option to "no renew option"
donot - set the domain's renew option to "do not renew"
auto - set the domain's renew option to "auto-renew"

Haverá 1 linha de resultado para cada solicitação enviada. Cada linha terá 2 campos.

Campo de Resultado da Definição das Opções de Renovação
Explicação
1The result of the set renew options requestThe result of the set renew options request:
success - the renew options were successfully set
error - there was a syntax error processing this request
2Mais informações sobre o resultado, usado somente quando o resultado é um "erro"

Exemplo de Definição das Opções de Renovação

Solicitação

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=set_renew_option&domain=mydomain.com&renew-option=donot

Resposta

ok, success,

Comando de Definição de Pasta

Ao chamar o comando de definição de pasta, os seguintes parâmetros devem ser incluídos:

Parâmetro de solicitação de definição de pasta
Explicação
domainO nome de domínio a ser atualizado, apenas 1 domínio pode ser definido por solicitação
folderThe folder name that you want to move your domain in
Use "Default" as the folder name if you want to move the domain to the default folder
Folder name is case sensitive, for example, "Folder1" and "folder1" are two different folder names

Haverá 1 linha de resultado para cada solicitação enviada. Cada linha terá 2 campos.

Parâmetro de Solicitação de Definição de Pasta
Explicação
1The result of the set folder request:
success - the folder was successfully set
error - there was a syntax error processing this request
2Mais informações sobre o resultado, usado somente quando o resultado é um "erro"

Exemplo de Definição de Pasta

Solicitação

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=set_folder&domain=mydomain.com&folder=folder1

Resposta

ok, success,

Comando de em processamento

Ao chamar o comando is_processing, os seguintes parâmetros devem ser incluídos:

Parâmetro de solicitação em processamento
Explicação
nenhum parâmetro adicional é necessário

Haverá 1 linha de resultado para cada domínio enviado. Cada linha terá 1 campos.

Campo de resultado em processamento
Explicação
1The result of the is_processing request:
yes - there is a request is processing, shouldn't send a new request
no - no request is processing. Safe to send a new request.

Exemplo de em Processamento

Solicitação

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=is_processing

Resposta

ok, yes,

Idiomas

Afrikaans:afr Chinese:chi Arabic:ara Persian:per Russian:rus Japanese:jpn Spanish:spa Hebrew:heb Korean:kor Bulgarian:bul Chinese-Simplified:zh-cn French:fre Hungarian:hun Turkish:tur Danish:dan Thai:tha German:ger Hindi:hin Greek:gre Icelandic:ice Portuguese:por Swedish:swe Polish:pol Ukrainian:ukr Chinese-Traditional:zh-tw Bosnian:bos Czech:cze Norwegian:nor Finnish:fin Italian:ita Cyrillic:cyrl Belarusian:bel Georgian:geo Vietnamese:vie Latvian:lav Bengali:ben Albanian:alb Romanian:rum Serbian:scc Tamil:tam Panjabi:pan Slovak:slo Armenian:arm Irish:gle Catalan:cat Urdu:urd Slovenian:slv Gujarati:guj Lithuanian:lit Macedonian:mac Khmer:khm Telugu:tel Dutch:dut Kazakh:kaz Malayalam:mal Welsh:wel Tibetan:tib Estonian:est Indic:inc Mongolian:mon Gaelic:gla Bodo:brx Uzbek:uzb Somali:som Javanese:jav Pushto:pus Swahili:swa Aragonese:arg Assamese:asm Sanskrit:san Chechen:che Kirghiz:kir Luxembourgish:ltz Maltese:mlt Kashmiri:kas Yiddish:yid Burmese:bur Nepali:nep Carib:car Coptic:cop Malay:may Syriac:syr Oriya:ori Samoan:smo Asturian:ast Avestan:ave Awadhi:awa Azerbaijani:aze Balinese:ban Baluchi:bal Basa:bas Bashkir:bak Basque:baq Bhojpuri:bho Chuvash:chv Corsican:cos Croatian:scr Divehi:div Dogri:doi Faroese:fao Fijian:fij Frisian:fry Gondi:gon Indonesian:ind Ingush:inh Kurdish:kur Lao:lao Maori:mao Moldavian:mol Ossetian:oss Rajasthani:raj Sardinian:srd Sindhi:snd Sinhalese:sin Tajik:tgk Latin:latn Konkani:knn Maithili:mai Marathi:mar Punjabi:pun