Domini

Elenco comandi API dominio

La nostra API è il tuo toolkit avanzato per la gestione e l'acquisizione di domini, progettato per l'efficienza. Con oltre 50 comandi per configurare, gestire, registrare e fare offerte in tutta la piattaforma Dynadot, avrai il pieno controllo sul tuo account e sulle impostazioni dei domini su qualsiasi software API tu scelga. La nostra API per domini è disponibile per tutti gli account, quindi inizia oggi!

Come iniziare con la nostra API Advanced Domain

API legacy, programmata per la dismissione. Usa invece la nostra API RESTful:

https://www.dynadot.com/domain/api-document

Le richieste alla nostra API Advanced Domain vengono inviate al seguente URL:

https://api.dynadot.com/api3.xml

Le richieste devono essere inviate tramite https (socket sicuro) per motivi di sicurezza. La richiesta deve avere i seguenti due parametri, 'Key' e 'Command'. È possibile fare clic su ciascun comando per vedere i parametri associati.

Riceverai un numero di thread diverso in base al livello di spesa del tuo account:

Livello di spesaPanoramica sui webhookLimite di frequenza
Regolare1 thread60/min (1/sec)
Bulk5 thread600/min (10/sec)
super bulk35 thread6000/min (100/sec)

 
Parametro di richiesta
Spiegazione
KeyLa tua chiave per accedere all'API, disponibile nel pannello di controllo del tuo account Dynadot sotto il menu laterale 'Tools' -> 'API'.
Command
Dominio:
search, register, delete, renew, push, transfer, bulk_register, restore

domain_info, set_whois, set_ns, set_parking, set_forwarding, set_stealth, set_hosting, set_dns2, set_email_forward, set_clear_domain_setting, set_folder, set_note, set_renew_option, set_privacy, tld_price, list_domain, lock_domain, suggestion_search, set_dnssec, get_dnssec, clear_dnssec

cancel_transfer, get_transfer_status, set_transfer_auth_code, authorize_transfer_away, get_transfer_auth_code

get_domain_push_request, set_domain_push_request
contatto:
create_cn_audit, get_cn_audit_status, create_contact, edit_contact, delete_contact, contact_list, get_contact

set_contact_eu_setting, set_contact_lv_setting, set_contact_lt_setting
Nameserver:
get_ns, add_ns, register_ns, set_ns_ip, delete_ns, delete_ns_by_domain, server_list, get_dns
Account:
account_info, get_account_balance, set_default_whois, set_default_ns, set_default_parking, set_default_forwarding, set_default_stealth, set_default_hosting, set_default_dns, set_default_dns2, set_default_email_forward, set_clear_default_setting, set_default_renew_option
Cartella:
create_folder, delete_folder, set_folder_whois, set_folder_ns, set_folder_parking, set_folder_forwarding, set_folder_stealth, set_folder_hosting, set_folder_dns, set_folder_dns2, set_folder_email_forward, set_clear_folder_setting, set_folder_name, set_folder_renew_option, folder_list
Mercato secondario:
add_backorder_request, delete_backorder_request, backorder_request_list

get_open_auctions, get_auction_details, get_auction_bids, place_auction_bid, get_closed_auctions

get_open_backorder_auctions, get_backorder_auction_details, place_backorder_auction_bid, get_closed_backorder_auctions, get_expired_closeout_domains, buy_expired_closeout_domain, get_listings, get_listing_item, buy_it_now, add_new_lead
Altro:
set_afternic_confirm_action, set_sedo_confirm_action, get_whois_stats, order_list, set_for_sale, get_order_status, is_processing, transfer_out_domain_list, list_coupons, download_all_listings

Formato XML. La risposta che ricevi dovrebbe contenere 2 o 3 dei seguenti campi:

Tag XML del risultato
Spiegazione
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
 

Comando di ricerca

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando search, i seguenti parametri devono essere inclusi:

Parametro della richiesta di ricerca
Spiegazione
domain0 - domain99Il nome di dominio che stai cercando, un account normale può specificare 1 dominio per comando, un account bulk e super bulk può specificare fino a 100 domini
language0 - language99 (optional)Il tag della lingua per il rispettivo dominio, usalo solo per gli IDN
show_price (optional)Se vuoi mostrare il prezzo nella valuta del tuo account, impostalo uguale a "1". Se il dominio è disponibile, verranno visualizzati i dettagli premium e le informazioni sul prezzo.
currency (optional)Puoi decidere il tipo di valuta e i valori supportati per questo parametro sono "USD","CNY", "GBP","EUR","INR","CAD" e così via. Se hai omesso questo parametro, useremo la valuta predefinita dell'account
Tag XML del risultato
Spiegazione
<Results></Results>Il nodo radice della risposta XML del comando di ricerca
<SearchResponse></SearchResponse>Tag della risposta di ricerca
<SearchHeader></SearchHeader>Tag dell'intestazione di ricerca
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<DomainName></DomainName>Il nome di dominio che hai appena cercato
<Available></Available>Se il nome di dominio è disponibile
<Price></Price>Se imposti "show_price" uguale a "1", questo ti indicherà le informazioni sul prezzo se questo dominio è disponibile.
<Language></Language>Informazioni sulla lingua del nome di dominio

Esempio di ricerca

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1&currency=USD
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1&currency=USD
Risposta (formato XML)
<Results>
  <SearchResponse>
    <SearchHeader>
      <SuccessCode>0</SuccessCode>
      <DomainName>mydomain.com</DomainName>
      <Available>yes</Available>
      <Price>77.00 in USD</Price>
    </SearchHeader>
  </SearchResponse>
  <SearchResponse>
    <SearchHeader>
      <SuccessCode>0</SuccessCode>
      <DomainName>mydomain.net</DomainName>
      <Available>yes</Available>
      <Price>44.00 in USD and domain is not premium</Price>
    </SearchHeader>
  </SearchResponse>
</Results>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1&currency=USD
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1&currency=USD
Risposta (formato JSON)
{
   "SearchResponse":{
      "ResponseCode":"0",
      "SearchResults":[
         {
            "DomainName":"mydomain.com",
            "Available":"yes",
            "Price":"77.00 in USD"
         },
         {
            "DomainName":"mydomain.net",
            "Available":"yes",
            "Price":"44.00 in USD"
         }
      ]
   }
}
 

Comando di registrazione

Supporto multi-thread
Supporta API Sandbox

Chiamando il comando register verrà creato ed elaborato un ordine di registrazione. Devi avere abbastanza saldo sul conto per pagare l'ordine. Se chiami il comando register, dovrebbero essere inclusi i seguenti parametri:

Parametro della richiesta Register
Spiegazione
domainIl nome di dominio che vuoi registrare, è possibile registrare solo 1 dominio per richiesta
language (optional)Il tag di lingua per il dominio richiesto, necessario solo se il dominio è un IDN
durationPer quanto tempo registrare il dominio
registrant_contact (optional)Il contatto del registrante che vuoi utilizzare sul dominio
admin_contact (optional)Il contatto amministrativo che vuoi usare per il dominio
technical_contact (optional)Il contatto tecnico che vuoi usare per il dominio
billing_contact (optional)Il contatto di fatturazione che vuoi utilizzare per il dominio
option0 (if necessary)
Il nome del registrante per .AT, .BE
option1 (if necessary)L'organizzazione del registrante per .AT, .BE (opzionale)
Per .AT, puoi specificare option0, option1 o entrambi
premium (optional)Se vuoi registrare un dominio premium, impostalo uguale a "1" (opzionale)
currency (optional)Puoi decidere il tipo di valuta e i valori supportati per questo parametro sono "USD","CNY", "GBP","EUR","INR","CAD" e così via. Se hai omesso questo parametro, useremo la valuta predefinita dell'account
coupon (optional)Il codice coupon che desideri applicare a questo comando
Tag XML del risultato
Spiegazione
<RegisterResponse></RegisterResponse>Tag della risposta di registrazione
<RegisterHeader></RegisterHeader>Tag dell'intestazione del registro
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<RegisterContent></RegisterContent>Il tag del contenuto di registrazione
<Expiration></Expiration>Data di scadenza in tempo Unix (millisecondi dalla mezzanotte UTC del 1 gennaio 1970), usata solo quando il risultato è "success"
<Registration></Registration>Data di registrazione in tempo Unix (millisecondi dalla mezzanotte UTC del 1 gennaio 1970), utilizzata solo quando il risultato è "success"

Esempio di registrazione

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=register&domain=domain1.net&duration=3&currency=USD
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=register&domain=domain1.net&duration=3&currency=USD
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<RegisterResponse>
  <RegisterHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RegisterHeader>
  <RegisterContent>
    <Expiration>1458379145266</Expiration>
  </RegisterContent>
</RegisterResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=register&domain=domain1.net&duration=3&currency=USD
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=register&domain=domain1.net&duration=3&currency=USD
Risposta (formato JSON)
{
  "RegisterResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "DomainName": "domain1.net",
    "Expiration": 1458379145266
  }
}
 

Comando Elimina

Supporto multi-thread
Supporta API Sandbox

Chiamare il comando delete eliminerà un dominio che è ancora nel periodo di grazia. Il saldo del tuo account verrà riaccreditato con la tassa di registrazione. I domini che sono stati rinnovati, o che sono stati spostati in un nuovo account, non possono essere eliminati tramite l'API. Se si chiama il comando delete, dovrebbero essere inclusi i seguenti parametri:

Parametro richiesta eliminazione
Spiegazione
domainIl nome di dominio che vuoi eliminare, è possibile eliminare solo 1 dominio per richiesta
Tag XML del risultato
Spiegazione
<DeleteResponse></DeleteResponse>Tag della risposta di eliminazione
<DeleteHeader></DeleteHeader>Tag dell'intestazione di eliminazione
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di eliminazione

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete&domain=domain1.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete&domain=domain1.com
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteResponse>
  <DeleteHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteHeader>
</DeleteResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete&domain=domain1.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete&domain=domain1.com
Risposta (formato JSON)
{
  "DeleteResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "DomainName": "domain1.com"
  }
}
 

Comando di rinnovo

Supporto multi-thread
Supporta API Sandbox

Chiamare il comando renew creerà ed elaborerà un ordine di rinnovo. Devi avere abbastanza saldo sul conto per pagare l'ordine. Se chiami il comando renew, dovrebbero essere inclusi i seguenti parametri:

Parametro della richiesta di rinnovo
Spiegazione
domainIl nome di dominio che vuoi rinnovare, è possibile rinnovare solo 1 dominio per richiesta
durationPer quanti anni rinnovare il dominio
year (optional)L'anno corrente in cui scade il dominio
currency (optional)Puoi decidere il tipo di valuta e i valori supportati per questo parametro sono "USD","CNY", "GBP","EUR","INR","CAD" e così via. Se hai omesso questo parametro, useremo la valuta predefinita dell'account
price_check (optional)Puoi aggiungere questo parametro al comando per controllare il dettaglio del prezzo per il rinnovo di questo dominio. NOTA: aggiungendo questo parametro al comando, la nostra API non rinnoverà il dominio, ma mostrerà solo le informazioni sul prezzo.
coupon (optional)Il codice coupon che desideri applicare a questo comando
no_renew_if_late_renew_fee_needed (optional)Puoi aggiungere questo parametro al comando per evitare il rinnovo se il dominio richiede un costo di rinnovo tardivo. Se il dominio richiede effettivamente un costo di rinnovo tardivo per il rinnovo, e "no_renew_if_late_renew_fee_needed = 1" è stato passato nel comando, il dominio non verrà rinnovato.
Tag XML del risultato
Spiegazione
<RenewResponse></RenewResponse>Tag della risposta di rinnovo, è il nodo radice del documento XML di risposta
<RenewHeader></RenewHeader>Intestazione rinnovo
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<PriceInfo></PriceInfo>Tag delle informazioni sul prezzo, viene usato solo quando lo stato è "price_check_success"
<RenewContent></RenewContent>Tag del contenuto di rinnovo, viene usato solo quando lo stato è "success"
<Expiration></Expiration>Data di scadenza in tempo Unix (millisecondi dalla mezzanotte UTC del 1 gennaio 1970), usata solo quando il risultato è "success"

Esempio di rinnovo

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&domain=domian1.com&command=renew&duration=1&currency=USD&coupon=testcoupon
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&domain=domian1.com&command=renew&duration=1&currency=USD&coupon=testcoupon
Risposta (formato XML)
<RenewResponse>
  <RenewHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RenewHeader>
  <RenewContent>
    <Expiration>73984579834</Expiration>
  </RenewContent>
</RenewResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&domain=domian1.com&command=renew&duration=1&currency=USD&coupon=testcoupon
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&domain=domian1.com&command=renew&duration=1&currency=USD&coupon=testcoupon
Risposta (formato JSON)
{
   "RenewResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "DomainName":"domain1.com",
      "Expiration":"73984579834"
   }
}
 

Comando Push

Supporto multi-thread
Supporta API Sandbox

La chiamata al comando push creerà ed elaborerà un ordine di push. Devi sbloccare il tuo dominio e il tuo account per l'ordine. L'account ricevente deve rifiutare/accettare il dominio per completare l'ordine. Se chiami il comando push, è necessario includere i seguenti parametri:

Parametro della richiesta di push
Spiegazione
domainIl nome di dominio che vuoi pushare. Supportiamo anche il push in blocco, puoi usare ";" per separare i domini. Esempio: domain1.com;domain2.com
receiver_push_usernameNome utente push dell'account del destinatario
currency (optional)Puoi decidere il tipo di valuta e i valori supportati per questo parametro sono "USD","CNY", "GBP","EUR","INR","CAD" e così via. Se hai omesso questo parametro, useremo la valuta predefinita dell'account
unlock_domain_for_push(optional)Imposta questo parametro uguale a "1". Se il dominio è bloccato, lo sbloccheremo automaticamente, quindi non devi sbloccare manualmente il dominio
receiver_email(optional)Email push dell'account destinatario
Tag XML del risultato
Spiegazione
<PushResponse></PushResponse>Tag della risposta push, è il nodo radice del documento XML di risposta
<PushHeader></PushHeader>Header push
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di push

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=push&domain=domian1.com&receiver_push_username=username&currency=USD
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=push&domain=domian1.com&receiver_push_username=username&currency=USD
Risposta (formato XML)
<PushResponse>
  <PushHeader>
    <SuccessCode>0</SuccessCode>
    <Status>order created</Status>
  </PushHeader>
</PushResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=push&domain=domian1.com&receiver_push_username=username&currency=USD
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=push&domain=domian1.com&receiver_push_username=username&currency=USD
Risposta (formato JSON)
{
   "PushResponse":{
      "ResponseCode":"0",
      "Status":"order created"
   }
}
 

Comando di trasferimento

Supporto multi-thread
Supporta API Sandbox

Chiamare il comando di trasferimento creerà ed elaborerà un ordine di trasferimento. Alcuni TLD potrebbero richiedere che il registrar perdente confermi per completare l'ordine. Se si chiama il comando di trasferimento, è necessario includere i seguenti parametri:

Parametro della richiesta di trasferimento
Spiegazione
domainIl nome di dominio che vuoi trasferire in Dynadot, è possibile trasferire solo 1 dominio per richiesta
authIl codice di autorizzazione per la richiesta di trasferimento.
currency (optional)Puoi decidere il tipo di valuta e i valori supportati per questo parametro sono "USD","CNY", "GBP","EUR","INR","CAD" e così via. Se hai omesso questo parametro, useremo la valuta predefinita dell'account
registrant_contact (optional)Il contatto del registrante che vuoi utilizzare quando il trasferimento è completato. (Non tutti i tld supportano questa funzione)
admin_contact (optional)Il contatto admin che vuoi usare quando il trasferimento è completato. (Non tutti i TLD supportano questa funzione)
technical_contact (optional)Il contatto tecnico che desideri utilizzare quando il trasferimento è completato. (Non tutti i tld supportano questa funzione)
billing_contact (optional)Il contatto di fatturazione che vuoi usare quando il trasferimento è completato. (Non tutti i TLD supportano questa funzione)
premium (optional)Se vuoi trasferire un dominio premium, impostalo uguale a "1" (opzionale)
privacy (optional)Lo stato di privacy del dominio che vuoi impostare può essere "on" o "off". Se l'input non è corretto o non viene fornito, verrà applicato il livello di privacy predefinito dell'account.
name_servers (optional)La lista dei name server da applicare al dominio una volta completato il trasferimento. Puoi usare "," per separare i name server. Esempio: ns1.domain1.com,ns2.domain2.com
coupon (optional)Il codice coupon che desideri applicare a questo comando
Tag XML del risultato
Spiegazione
<TransferResponse></TransferResponse>Tag della risposta di trasferimento, è il nodo radice del documento XML di risposta
<TransferHeader></TransferHeader>Intestazione del trasferimento
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di trasferimento

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=transfer&domain=domian1.com&auth=testauth&currency=USD&coupon=testcoupon
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=transfer&domain=domian1.com&auth=testauth&currency=USD&coupon=testcoupon
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<TransferResponse>
  <TransferHeader>
    <SuccessCode>0</SuccessCode>
    <Status>order created</Status>
    <DomainName>domain1.com</DomainName>
    <OrderId>1234567</OrderId>
  </TransferHeader>
</TransferResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=transfer&domain=domian1.com&auth=testauth&currency=USD&coupon=testcoupon
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=transfer&domain=domian1.com&auth=testauth&currency=USD&coupon=testcoupon
Risposta (formato JSON)
{
  "TransferResponse": {
    "ResponseCode": 0,
    "Status": "order created",
    "DomainName": "domain1.com",
    "OrderId": "1234567"
  }
}
 

Comando di registrazione in blocco

Supporto multi-thread
Supporta API Sandbox

Chiamare il comando bulk register creerà ed elaborerà gli ordini di registrazione. Devi avere un saldo del conto sufficiente per pagare gli ordini. Se si chiama il comando bulk register, i seguenti parametri devono essere inclusi:

Parametro della richiesta di registrazione in blocco
Spiegazione
domain0-domain99I nomi di dominio che vuoi registrare, puoi registrare un massimo di 100 domini per richiesta
premium (optional)Se vuoi registrare un dominio premium, impostalo uguale a "1" (opzionale)
currency (optional)Puoi decidere il tipo di valuta e i valori supportati per questo parametro sono "USD","CNY", "GBP","EUR","INR","CAD" e così via. Se hai omesso questo parametro, useremo la valuta predefinita dell'account
coupon (optional)Il codice coupon che desideri applicare a questo comando
Tag XML del risultato
Spiegazione
<BulkRegisterResponse></BulkRegisterResponse>Tag della risposta di registrazione in blocco
<BulkRegisterHeader></BulkRegisterHeader>Tag dell'intestazione di registrazione massiva
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<BulkRegisterContent></BulkRegisterContent>Il tag del contenuto della registrazione massiva
<Expiration></Expiration>Data di scadenza in tempo Unix (millisecondi dalla mezzanotte UTC del 1 gennaio 1970), usata solo quando il risultato è "success"
<Result></Result>Il risultato dell'azione di registrazione
<Message></Message>Messaggio di errore dell'azione di registrazione, usato solo quando il risultato è "error"

Esempio di registrazione in blocco

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com&currency=USD
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com&currency=USD
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<BulkRegisterResponse>
  <BulkRegisterHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </BulkRegisterHeader>
  <BulkRegisterContent>
    <BulkRegister>
      <RegisterResult>
        <DomainName>domain0.com</DomainName>
        <Expiration>1234567890</Expiration>
        <Result>success</Result>
        <Message>-</Message>
      </RegisterResult>
      <RegisterResult>
        <DomainName>domain1.com</DomainName>
        <Expiration>-</Expiration>
        <Result>error</Result>
        <Message>not_available</Message>
      </RegisterResult>
    </BulkRegister>
  </BulkRegisterContent>
</BulkRegisterResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com&currency=USD
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com&currency=USD
Risposta (formato JSON)
{
  "BulkRegisterResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "BulkRegister": [
      {
        "DomainName": "domain0.com",
        "Expiration": "1234567890",
        "Result": "success",
        "Message": "-"
      },
      {
        "DomainName": "domain1.com",
        "Expiration": "-",
        "Result": "error",
        "Message": "not_available"
      }
    ]
  }
}
 

Comando di informazioni sul dominio

Supporto multi-thread
Supporta API Sandbox

Questo comando è disponibile solo nei formati XML e JSON:

Parametro della richiesta Domain Info
Spiegazione
domainSolo 1 dominio consentito per richiesta
Tag XML del risultato
Spiegazione
<DomainInfoResponse></DomainInfoResponse>Nodo radice del documento XML di risposta
<DomainInfoResponseHeader></DomainInfoResponseHeader>Intestazione della risposta
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<DomainInfoContent></DomainInfoContent>Contenuto della risposta
<Domain></Domain>Dominio
<Name></Name>Nome del dominio
<Expiration></Expiration>Data di scadenza del dominio in tempo Unix (millisecondi dalla mezzanotte UTC del 1° gennaio 1970)
<Registration></Registration>Data di registrazione del dominio in tempo Unix (millisecondi dalla mezzanotte UTC del 1° gennaio 1970)
<NameServerSettings></NameServerSettings>Impostazioni dei name server del dominio
<Type></Type>Tipo di nameserver del dominio
<WithAds></WithAds>Se desideri una pagina di parcheggio per il tuo dominio
<Whois></Whois>Informazioni Whois
<Registrant></Registrant>Informazioni registrante
<ContactId></ContactId>ID contatto
<Admin></Admin>Informazioni amministrative
<Technical></Technical>Informazioni tecniche
<Billing></Billing>Informazioni di fatturazione
<Locked></Locked>Bloccato o meno
<Disabled></Disabled>Stato di abilitazione
<UdrpLocked></UdrpLocked>Bloccato UDRP o no
<UdrpLocked></UdrpLocked>Bloccato UDRP o no
<RegistrantUnverified></RegistrantUnverified>Registrante non verificato
<Hold></Hold>Stato di sospensione Client/Registrar
<Privacy></Privacy>Stato privacy
<isForSale></isForSale>Stato di vendita
<RenewOption></RenewOption>Opzione di rinnovo
<Note></Note>Nota
<Folder></Folder>Informazioni sulla cartella
<FolderId></FolderId>ID cartella
<FolderName></FolderName>Nome della cartella

Esempio di informazioni sul dominio

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=domain_info&domain=domain1.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=domain_info&domain=domain1.com
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<DomainInfoResponse>
  <DomainInfoHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </DomainInfoHeader>
  <DomainInfoContent>
    <Domain>
      <Name>domain1.com</Name>
      <Expiration>1361430589062</Expiration>
      <Registration>1234567890123</Registration>
      <NameServerSettings>
        <Type>Dynadot Parking</Type>
        <WithAds>Yes</WithAds>
      </NameServerSettings>
      <Whois>
        <Registrant>
          <ContactId>0</ContactId>
        </Registrant>
        <Admin>
          <ContactId>0</ContactId>
        </Admin>
        <Technical>
          <ContactId>0</ContactId>
        </Technical>
        <Billing>
          <ContactId>0</ContactId>
        </Billing>
      </Whois>
      <Locked>yes</Locked>
      <Disabled>no</Disabled>
      <UdrpLocked>no</UdrpLocked>
      <RegistrantUnverified>no</RegistrantUnverified>
      <Hold>no</Hold>
      <Privacy>none</Privacy>
      <isForSale>yes</isForSale>
      <RenewOption>no renew option</RenewOption>
      <Note/>
      <Folder>
        <FolderId>-1</FolderId>
        <FolderName>(no folder)</FolderName>
      </Folder>
      <Status>active</Status>
    </Domain>
  </DomainInfoContent>
</DomainInfoResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=domain_info&domain=domain1.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=domain_info&domain=domain1.com
Risposta (formato JSON)
{
  "DomainInfoResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "DomainInfo": {
      "Name": "domain1.com",
      "Expiration": "1361430589062",
      "Registration": "1234567890123",
      "NameServerSettings": {
        "Type": "Dynadot Parking",
        "WithAds": "Yes"
      },
      "Whois": {
        "Registrant": {
          "ContactId": "0"
        },
        "Admin": {
          "ContactId": "0"
        },
        "Technical": {
          "ContactId": "0"
        },
        "Billing": {
          "ContactId": "0"
        }
      },
      "Locked": "yes",
      "Disabled": "no",
      "UdrpLocked": "no",
      "RegistrantUnverified": "no",
      "Hold": "no",
      "Privacy": "none",
      "isForSale": "yes",
      "RenewOption": "no renew option",
      "Note": "",
      "Folder": {
        "FolderId": "-1",
        "FolderName": "(no folder)"
      },
      "Status": "active"
    }
  }
}
 

Comando Imposta Whois

Supporto multi-thread
Supporta API Sandbox

Se chiami il comando set Whois, vanno inclusi i seguenti parametri:

Imposta parametro della richiesta Whois
Spiegazione
domainIl nome di dominio che vuoi impostare, puoi impostare 100 domini per richiesta, assicurati che siano separati da virgole
registrant_contactLe informazioni del registrante del dominio
admin_contactLe informazioni dell'amministratore del dominio
technical_contactLe informazioni tecniche del dominio
billing_contactLe informazioni di fatturazione del dominio
Tag XML del risultato
Spiegazione
<SetWhoisResponse></SetWhoisResponse>Nodo radice del documento XML di risposta
<SetWhoisHeader></SetWhoisHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione Whois

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_whois&domain=domain4.com&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_whois&domain=domain4.com&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Risposta (formato XML)
<SetWhoisResponse>
  <SetWhoisHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetWhoisHeader>
</SetWhoisResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_whois&domain=domain4.com&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_whois&domain=domain4.com&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Risposta (formato JSON)
{
   "SetWhoisResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Imposta Name Server

Supporto multi-thread
Supporta API Sandbox

Se si richiama il comando set name servers, occorre includere i seguenti parametri:

Parametro di richiesta per impostare i name server
Spiegazione
domainIl nome di dominio che vuoi impostare, puoi impostare 100 domini per richiesta, assicurati che siano separati da virgole
ns0 - ns12I name server da impostare per il tuo dominio, puoi specificare fino a 13 name server, ma devono essere già presenti nel tuo account
Tag XML del risultato
Spiegazione
<SetNsResponse></SetNsResponse>Tag della risposta di set name server, è il nodo radice del documento XML di risposta
<SetNsHeader></SetNsHeader>Tag dell'intestazione di risposta dell'impostazione name server
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione NS

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetNsResponse>
  <SetNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetNsHeader>
</SetNsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
Risposta (formato JSON)
{
  "SetNsResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

Comando Imposta Parcheggio

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set parking, è necessario includere i seguenti parametri:

Parametro della richiesta di impostazione del parcheggio
Spiegazione
domainIl nome di dominio che vuoi impostare, puoi impostare 100 domini per richiesta, assicurati che siano separati da virgole
with_ads (optional)Se non vuoi pubblicità di terze parti, puoi usare questo parametro con "no"
Tag XML del risultato
Spiegazione
<SetParkingResponse></SetParkingResponse>Tag della risposta set parking, è il nodo radice del documento XML di risposta
<SetParkingHeader></SetParkingHeader>Imposta intestazione cartella di parcheggio
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione del parking

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_parking&domain=domain1.com&with_ads=no
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_parking&domain=domain1.com&with_ads=no
Risposta (formato XML)
<SetParkingResponse>
  <SetParkingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetParkingHeader>
</SetParkingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_parking&domain=domain1.com&with_ads=no
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_parking&domain=domain1.com&with_ads=no
Risposta (formato JSON)
{
   "SetParkingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Imposta inoltro

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando di impostazione dell'inoltro, è necessario includere i seguenti parametri:

Parametro di richiesta per impostare l'inoltro
Spiegazione
domainIl nome di dominio che vuoi impostare, puoi impostare 100 domini per richiesta, assicurati che siano separati da virgole
forward_urlL'URL verso cui vuoi reindirizzare il tuo dominio. Tieni presente che il parametro deve essere codificato in modo che la chiamata API venga interpretata correttamente.
is_temp (optional)Stato di inoltro del tuo dominio che desideri, il valore predefinito è "temporary", se vuoi inoltrare permanentemente, usa questo parametro con "no"
Tag XML del risultato
Spiegazione
<SetForwardingResponse></SetForwardingResponse>Nodo radice del documento XML di risposta
<SetForwardingHeader></SetForwardingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione inoltro

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
Risposta (formato XML)
<SetForwardingResponse>
  <SetForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetForwardingHeader>
</SetForwardingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
Risposta (formato JSON)
{
   "SetForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Imposta comando stealth

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set stealth, è necessario includere i seguenti parametri:

Imposta Parametro Richiesta Stealth
Spiegazione
domainIl nome di dominio che vuoi impostare, puoi impostare 100 domini per richiesta, assicurati che siano separati da virgole
stealth_urlL'URL verso cui vuoi reindirizzare il tuo dominio. Tieni presente che il parametro deve essere codificato in modo che la chiamata API venga interpretata correttamente.
stealth_title (optional)Il titolo della pagina
Tag XML del risultato
Spiegazione
<SetStealthResponse></SetStealthResponse>Nodo radice del documento XML di risposta
<SetStealthHeader></SetStealthHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione Stealth

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Risposta (formato XML)
<SetStealthResponse>
  <SetStealthHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetStealthHeader>
</SetStealthResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Risposta (formato JSON)
{
   "SetStealthResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando di impostazione dell'hosting

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set hosting, è necessario includere i seguenti parametri:

Parametro della richiesta di impostazione hosting
Spiegazione
domainIl nome di dominio che vuoi impostare, puoi impostare 100 domini per richiesta, assicurati che siano separati da virgole
hosting_typeTipo di hosting desiderato, puoi scegliere tra "advanced" e "basic"
mobile_view_onSolo quando hosting_type è "advanced", puoi usare questo parametro come "yes"
Tag XML del risultato
Spiegazione
<SetHostingResponse></SetHostingResponse>Nodo radice del documento XML di risposta
<SetHostingHeader></SetHostingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione hosting

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
Risposta (formato XML)
<SetHostingResponse>
  <SetHostingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetHostingHeader>
</SetHostingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
Risposta (formato JSON)
{
   "SetHostingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Imposta DNS2

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set DNS2, è necessario includere i seguenti parametri:

Nota che eseguire il comando SET_DNS2 sovrascriverà, per impostazione predefinita, le impostazioni DNS correnti. Per modificare questo comportamento e aggiungere invece le nuove impostazioni DNS, puoi usare il parametro opzionale add_dns_to_current_setting.

Imposta parametro della richiesta DNS2
Spiegazione
domainIl nome di dominio che vuoi impostare, puoi impostare 100 domini per richiesta, assicurati che siano separati da virgole
main_record_type0 - main_record_type19 (optional)Tipo di record principale, dovrebbe essere "a", "aaaa", "cname", "forward", "txt", "mx", "stealth", "email"
main_record0 - main_record19Specifica il record DNS per il tuo dominio
main_recordx0 - main_recordx19Distanza Mx, tipo di forward (301 come "1", 302 come "2"), titolo del forward stealth o alias email, necessario quando main_record_type è "forward","mx","stealth","email".
subdomain0 - subdomain99 (optional)Record del sottodominio (opzionale)
sub_record_type0 - sub_record_type99Tipo di record del sottodominio, dovrebbe essere "a", "aaaa", "cname", "forward", "txt", "srv", "mx", "stealth", "email"
sub_record0 - sub_record99Indirizzo IP del sottodominio o host di destinazione
sub_recordx0 - sub_recordx99Distanza MX, tipo di inoltro, titolo di inoltro stealth o alias email, necessario quando main_record_type è "forward","mx","stealth","email"
ttl (optional)Tempo di vita
add_dns_to_current_setting (optional)se vuoi aggiungere le nuove impostazioni DNS alle impostazioni DNS esistenti. Impostalo uguale a "1" (opzionale)
Tag XML del risultato
Spiegazione
<SetDnsResponse></SetDnsResponse>Nodo radice del documento XML di risposta
<SetDnsHeader></SetDnsHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione DNS2

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetDnsResponse>
  <SetDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDnsHeader>
</SetDnsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
Risposta (formato JSON)
{
  "SetDnsResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

Comando per impostare DNSSEC

Supporto multi-thread
Supporta API Sandbox

La chiamata al comando Set Dnssec imposterà il dnssec del dominio. Questo comando è disponibile solo in formato XML e JSON. Se si chiama questo comando, i seguenti parametri devono essere inclusi:

Puoi scegliere di inserire i valori dei parametri corrispondenti nell'Opzione in base al tuo nome di dominio.

Opzione 1 : domain_name , key_tag , digest_type , digest , algorithm

Opzione 2 : domain_name , flags , public_key , algorithm

Note: Seleziona il numero dell'etichetta corrispondente come valore del tuo parametro, se presente.

Parametro della richiesta Set Dnssec
Spiegazione
domain_nameIl nome di dominio per cui devi configurare DNSSEC
key_tagTag della chiave
digest_typePuoi scegliere un numero dall'elenco seguente per rappresentare il tuo tipo di firma digitale: SHA-1(1) SHA-256(2) GOSTR 34.11-94 (3) SHA-384(4)
digestInserisci il valore corrispondente al tipo di digest che hai selezionato
algorithmPuoi scegliere un numero dal seguente elenco per rappresentare il tuo algoritmo di firma digitale: RSA/MD5(1) Diffie-Hellman (2) DSA/SHA-1(3) Curva Ellittica (4) RSA/SHA-1(5) DSA-NSEC3-SHA1(6) RSASHA1-NSEC3-SHA1(7) RSA/SHA-256(8) RSA/SHA-512(10) GOSTR 34.10-2001(12) ECDSA Curva P-256 con SHA-256(13 ECDSA Curva P-384 con SHA-384(14) ED25519(15 ED448(16) Indiretto (252) DNS privato (253 OID privato (254)
flagsPuoi scegliere un numero dal seguente elenco per rappresentare il simbolo della tua firma digitale: ZSK(256) KSK(257)
public_keyLa chiave pubblica deve essere in codifica base64.
Tag XML del risultato
Spiegazione
<SetDnssecResponse></SetDnssecResponse>il nodo radice della risposta
<SetDnssecHeader></SetDnssecHeader>Imposta header Dnssec
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione Dnssec

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetDnssecResponse>
  <SetDnssecHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDnssecHeader>
  <SetDnssecContent/>
</SetDnssecResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
Risposta (formato JSON)
{
  "SetDnssecResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

Comando Clear Dnssec

Supporto multi-thread
Supporta API Sandbox

Chiamando il comando Clear Dnssec verrà cancellato il dnssec del dominio. Questo comando è disponibile solo in formato XML e JSON. Se chiami questo comando, devono essere inclusi i seguenti parametri:

Parametro della richiesta Clear Dnssec
Spiegazione
domain_nameIl nome di dominio per cui devi cancellare il dnssec

Esempio di Clear Dnssec

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=clear_dnssec&domain_name=domain-haha1.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=clear_dnssec&domain_name=domain-haha1.com
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<ClearDnssecResponse>
  <ClearDnssecHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ClearDnssecHeader>
</ClearDnssecResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=clear_dnssec&domain_name=domain-haha1.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=clear_dnssec&domain_name=domain-haha1.com
Risposta (formato JSON)
{
  "ClearDnssecResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

Comando Imposta inoltro email

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set email forward, è necessario includere i seguenti parametri:

Imposta parametro richiesta inoltro email
Spiegazione
domainIl nome di dominio che vuoi impostare, puoi impostare 100 domini per richiesta, assicurati che siano separati da virgole
forward_typeTipo di inoltro, può essere "donot": Non inoltrare email, "mx": Consegna email a un altro host di posta (record MX), "forward": Consegna email a un altro host di posta
username0 - username9Nome utente, usato solo quando "forward_type" è "forward"
exist_email0 - exist_email9Indirizzo email esistente, utilizzato solo quando "forward_type" è "forward"
mx_host0 - mx_host2Host della posta, usato solo quando "forward_type" è "mx"
mx_distance0 - mx_distance2Distance0 è la priorità più alta, utilizzato solo quando "forward_type" è "mx"
Tag XML del risultato
Spiegazione
<SetEmailForwardingResponse></SetEmailForwardingResponse>Nodo radice del documento XML di risposta
<SetEmailForwardingHeader></SetEmailForwardingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di Set Email Forward

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&[email protected]
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&[email protected]
Risposta (formato XML)
<SetEmailForwardingResponse>
  <SetEmailForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetEmailForwardingHeader>
</SetEmailForwardingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&[email protected]
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&[email protected]
Risposta (formato JSON)
{
   "SetEmailForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando per impostare la cancellazione delle impostazioni del dominio

Supporto multi-thread
Supporta API Sandbox

Se chiami il comando set clear domain setting, vanno inclusi i seguenti parametri:

Parametro di richiesta Imposta/Cancella impostazione dominio
Spiegazione
domainIl nome di dominio che vuoi impostare, puoi impostare 100 domini per richiesta, assicurati che siano separati da virgole
serviceIl servizio che vuoi cancellare, può essere "forward", "stealth", "email_forwarding", "dns", "dnssec" e "nameservers"
Tag XML del risultato
Spiegazione
<SetClearDomainSettingResponse></SetClearDomainSettingResponse>Nodo radice del documento XML di risposta
<SetClearDomainSettingHeader></SetClearDomainSettingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di Set Clear Domain Setting

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
Risposta (formato XML)
<SetClearDomainSettingResponse>
  <SetClearDomainSettingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetClearDomainSettingHeader>
</SetClearDomainSettingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
Risposta (formato JSON)
{
   "SetClearDomainSettingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Imposta cartella

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set folder, i seguenti parametri dovrebbero essere inclusi:

Parametro della richiesta di impostazione della cartella
Spiegazione
domainIl nome di dominio da aggiornare, è possibile impostare solo 1 dominio per richiesta
folderIl nome della cartella in cui vuoi spostare il tuo dominio. Usa "Default" come nome della cartella se vuoi spostare il dominio nella cartella predefinita. Il nome della cartella distingue tra maiuscole e minuscole. Ad esempio, "Folder1" e "folder1" sono due nomi di cartella diversi.
folder_id (optional)L'ID della cartella in cui vuoi spostare il tuo dominio
Tag XML del risultato
Spiegazione
<SetFolderResponse></SetFolderResponse>Tag della risposta di impostazione della cartella, è il nodo radice del documento XML di risposta
<SetFolderHeader></SetFolderHeader>Imposta intestazione cartella
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione cartella

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder&domain=domian1.com&folder=folder1
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder&domain=domian1.com&folder=folder1
Risposta (formato XML)
<SetFolderResponse>
  <SetFolderHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderHeader>
</SetFolderResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder&domain=domian1.com&folder=folder1
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder&domain=domian1.com&folder=folder1
Risposta (formato JSON)
{
   "SetFolderResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Imposta Nota

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set note, è necessario includere i seguenti parametri:

Parametro della richiesta Imposta nota
Spiegazione
domainIl dominio che vuoi impostare, è possibile impostare solo 1 dominio per richiesta
noteNota che vuoi impostare al dominio, può essere nulla
Tag XML del risultato
Spiegazione
<SetNoteResponse></SetNoteResponse>Nodo radice del documento XML di risposta
<SetNoteHeader></SetNoteHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione della nota

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_note&domain=domain1.com&note=Do not modify any information
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_note&domain=domain1.com&note=Do not modify any information
Risposta (formato XML)
<SetNoteResponse>
  <SetNoteHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetNoteHeader>
</SetNoteResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_note&domain=domain1.com&note=Do not modify any information
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_note&domain=domain1.com&note=Do not modify any information
Risposta (formato JSON)
{
   "SetNoteResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Imposta l'opzione di rinnovo

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set renew option, è necessario includere i seguenti parametri:

Imposta il parametro di richiesta dell'opzione di rinnovo
Spiegazione
domainIl nome di dominio che vuoi impostare, puoi impostare 100 domini per richiesta, assicurati che siano separati da virgole
renew_optionPuò essere "donot", "auto", "reset"
Tag XML del risultato
Spiegazione
<SetRenewOptionResponse></SetRenewOptionResponse>Nodo radice del documento XML di risposta
<SetRenewOptionHeader></SetRenewOptionHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione dell'opzione di rinnovo

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetRenewOptionResponse>
  <SetRenewOptionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetRenewOptionHeader>
</SetRenewOptionResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
Risposta (formato JSON)
{
  "SetRenewOptionResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

Comando Imposta privacy

Supporto multi-thread
Supporta API Sandbox

Se si richiama il comando set privacy, è necessario includere i seguenti parametri:

Parametro della richiesta Set Privacy Request
Spiegazione
domainIl nome di dominio che vuoi impostare, puoi impostare 100 domini per richiesta, assicurati che siano separati da virgole
optionLo stato di privacy del dominio che vuoi impostare può essere "full", "partial" o "off"
whois_privacy_optionLo stato di privacy whois del dominio che vuoi impostare, può essere "yes" o "no"
Tag XML del risultato
Spiegazione
<SetPrivacyResponse></SetPrivacyResponse>Nodo radice del documento XML di risposta
<SetPrivacyHeader></SetPrivacyHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione della privacy

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
Risposta (formato XML)
<SetPrivacyResponse>
  <SetPrivacyHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetPrivacyHeader>
</SetPrivacyResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
Risposta (formato JSON)
{
   "SetPrivacyResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Prezzi TLD

Supporto multi-thread
Supporta API Sandbox

Questa funzionalità è disponibile solo in formato XML e JSON:

Parametro di richiesta prezzi TLD
Spiegazione
currency (optional)La valuta del risultato restituito, dovrebbe essere "usd", "eur", o "cny", la valuta predefinita è Api Default Currency dell'impostazione dell'account
count_per_page (optional)Quante entità vengono visualizzate per pagina
page_index (optional)Le entità di quale pagina vuoi visualizzare
sort (optional)Seleziona una delle seguenti opzioni come valore per il parametro di ordinamento:
* Se non l'hai selezionato, useremo l'ordinamento predefinito.
1) RankAsc (Predefinito)
2) RankDesc
3) Nome crescente
4) NomeDesc
5) SalesAsc
6) SalesDesc
7) LaunchDateAsc
8) Data di lancio decrescente
9) CountAsc
10) CountDesc
11) RegistryAsc
12) RegistryDesc
Tag XML del risultato
Spiegazione
<TldPriceResponse></TldPriceResponse>Nodo radice del documento XML di risposta
<TldPriceResponseHeader></TldPriceResponseHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<TldPriceContent></TldPriceContent>Contenuto della risposta
<TldContent></TldContent>Informazioni TLD
<Tld></Tld>Domini di primo livello
<Usage></Usage>Utilizzo del TLD
<Price></Price>Informazioni sul prezzo di questo TLD. Contiene i sottotag: : Unità di prezzo : Prezzo della registrazione : Prezzo del rinnovo : Prezzo del trasferimento
<Privacy></Privacy>Se questo tld supporta whois privacy
<GracePeriod></GracePeriod>Informazioni sul periodo di grazia di questo TLD. Contiene sotto-tag: : Unità delle informazioni sul periodo di grazia : Periodo di grazia per il rinnovo : Periodo di grazia per l'eliminazione
<IDN></IDN>Se questo TLD supporta i nomi di dominio internazionalizzati
<Restrictions></Restrictions>Nome di dominio

Esempio di prezzi TLD

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=tld_price&currency=USD
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=tld_price&currency=USD
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<TldPriceResponse>
  <TldPriceResponseHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
    <PriceLevel>Regular Pricing</PriceLevel>
    <Currency>USD</Currency>
  </TldPriceResponseHeader>
  <TldPriceContent>
    <TldContent>
      <Tld>com</Tld>
      <Usage>General</Usage>
      <Price>
        <Unit>(Price/1 year)</Unit>
        <Register>15.00</Register>
        <Renew>15.00</Renew>
        <Transfer>15.00</Transfer>
        <Restore>10.00</Restore>
      </Price>
      <Privacy>10.00</Privacy>
      <GracePeriod>
        <Unit>10.00</Unit>
        <Renew>10.00</Renew>
        <Delete>30</Delete>
        <Restore>YES</Restore>
      </GracePeriod>
      <IDN>YES</IDN>
      <Restrictions>--</Restrictions>
      <OnSale>Yes</OnSale>
      <maxDuration>10</maxDuration>
      <minDuration>1</minDuration>
    </TldContent>
  </TldPriceContent>
</TldPriceResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=tld_price&currency=USD
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=tld_price&currency=USD
Risposta (formato JSON)
{
  "TldPriceResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "PriceLevel": "Regular Pricing",
    "Currency": "USD",
    "TldPrice": [
      {
        "Tld": "com",
        "Usage": "General",
        "IDN": "YES",
        "Restrictions": "--",
        "OnSale": "Yes",
        "Privacy": "10.00",
        "Price": {
          "Unit": "(Price/1 year)",
          "Register": "15.00",
          "Renew": "15.00",
          "Transfer": "15.00",
          "Restore": "10.00"
        },
        "GracePeriod": {
          "Unit": "10.00",
          "Renew": "10.00",
          "Delete": "30",
          "Restore": "YES"
        },
        "maxDuration": 10,
        "minDuration": 1
      }
    ]
  }
}
 

Comando di elenco domini

Supporto multi-thread
Supporta API Sandbox

Questa funzionalità è disponibile solo in formato XML e JSON:

Parametro della richiesta List Domain
Spiegazione
customer_id (optional)Filtra i dati per ID cliente (solo i rivenditori possono usare questo parametro)
count_per_page (optional)Quante entità vengono visualizzate per pagina
page_index (optional)Le entità di quale pagina vuoi visualizzare
sort (optional)Seleziona una delle seguenti opzioni come valore per il parametro di ordinamento:
* Se non l'hai selezionato, useremo l'ordinamento predefinito.
1) ConteggioAsc (Predefinito)
2) CountDesc
3) Nome crescente
4) NomeDesc
Tag XML del risultato
Spiegazione
<ListDomainInfoResponse></ListDomainInfoResponse>Nodo radice del documento XML di risposta
<ListDomainInfoHeader></ListDomainInfoHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<ListDomainInfoContent></ListDomainInfoContent>Contenuto della risposta
<DomainInfoList></DomainInfoList>Elenco informazioni dominio
<DomainInfo></DomainInfo>Informazioni sul dominio
<Domain></Domain>Dominio
<Name></Name>Nome di dominio
<Expiration></Expiration>Data di scadenza del dominio in tempo Unix (millisecondi dalla mezzanotte UTC del 1° gennaio 1970)
<Registration></Registration>Data di registrazione del dominio in tempo Unix (millisecondi dalla mezzanotte UTC del 1° gennaio 1970)
<NameServerSettings></NameServerSettings>Impostazioni del name server
<Type></Type>Tipo di impostazione del name server
<WithAds></WithAds>Con pubblicità o no
<Whois></Whois>Informazioni Whois
<Registrant></Registrant>Informazioni registrante
<ContactId></ContactId>ID contatto
<Admin></Admin>Informazioni amministrative
<Technical></Technical>Informazioni tecniche
<Billing></Billing>Informazioni di fatturazione
<Locked></Locked>Bloccato o meno
<Disabled></Disabled>Stato di abilitazione
<Hold></Hold>Stato di sospensione Client/Registrar
<Privacy></Privacy>Stato privacy
<isForSale></isForSale>Stato di vendita
<RenewOption></RenewOption>Opzione di rinnovo
<Note></Note>Nota
<Folder></Folder>Informazioni sulla cartella
<FolderId></FolderId>ID cartella
<FolderName></FolderName>Nome della cartella

Esempio di elenco domini

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=list_domain
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=list_domain
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<ListDomainInfoResponse>
  <ListDomainInfoHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ListDomainInfoHeader>
  <ListDomainInfoContent>
    <DomainInfoList>
      <DomainInfo>
        <Domain>
          <Name>domain-exp140.com</Name>
          <Expiration>1361430589062</Expiration>
          <Registration>1234567890123</Registration>
          <NameServerSettings>
            <Type>Dynadot Parking</Type>
            <WithAds>Yes</WithAds>
          </NameServerSettings>
          <Whois>
            <Registrant>
              <ContactId>0</ContactId>
            </Registrant>
            <Admin>
              <ContactId>0</ContactId>
            </Admin>
            <Technical>
              <ContactId>0</ContactId>
            </Technical>
            <Billing>
              <ContactId>0</ContactId>
            </Billing>
          </Whois>
          <Locked>yes</Locked>
          <Disabled>no</Disabled>
          <UdrpLocked>no</UdrpLocked>
          <RegistrantUnverified>no</RegistrantUnverified>
          <Hold>no</Hold>
          <Privacy>none</Privacy>
          <isForSale>no</isForSale>
          <RenewOption>no renew option</RenewOption>
          <Note/>
          <Folder>
            <FolderId>-1</FolderId>
            <FolderName>(no folder)</FolderName>
          </Folder>
          <Status>active</Status>
        </Domain>
        <Domain>
          <Name>domain-exp141.com</Name>
          <Expiration>1361430589062</Expiration>
          <Registration>1234567890123</Registration>
          <NameServerSettings>
            <Type>Dynadot Parking</Type>
            <WithAds>Yes</WithAds>
          </NameServerSettings>
          <Whois>
            <Registrant>
              <ContactId>1</ContactId>
            </Registrant>
            <Admin>
              <ContactId>2</ContactId>
            </Admin>
            <Technical>
              <ContactId>3</ContactId>
            </Technical>
            <Billing>
              <ContactId>4</ContactId>
            </Billing>
          </Whois>
          <Locked>yes</Locked>
          <Disabled>no</Disabled>
          <UdrpLocked>no</UdrpLocked>
          <RegistrantUnverified>no</RegistrantUnverified>
          <Hold>no</Hold>
          <Privacy>none</Privacy>
          <isForSale>no</isForSale>
          <RenewOption>no renew option</RenewOption>
          <Note/>
          <Folder>
            <FolderId>-1</FolderId>
            <FolderName>(no folder)</FolderName>
          </Folder>
          <Status>moved</Status>
        </Domain>
      </DomainInfo>
    </DomainInfoList>
  </ListDomainInfoContent>
</ListDomainInfoResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=list_domain
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=list_domain
Risposta (formato JSON)
{
  "ListDomainInfoResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "MainDomains": [
      {
        "Name": "domain-exp140.com",
        "Expiration": "1361430589062",
        "Registration": "1234567890123",
        "NameServerSettings": {
          "Type": "Dynadot Parking",
          "WithAds": "Yes"
        },
        "Whois": {
          "Registrant": {
            "ContactId": "0"
          },
          "Admin": {
            "ContactId": "0"
          },
          "Technical": {
            "ContactId": "0"
          },
          "Billing": {
            "ContactId": "0"
          }
        },
        "Locked": "yes",
        "Disabled": "no",
        "UdrpLocked": "no",
        "RegistrantUnverified": "no",
        "Hold": "no",
        "Privacy": "none",
        "isForSale": "no",
        "RenewOption": "no renew option",
        "Note": "",
        "Folder": {
          "FolderId": "-1",
          "FolderName": "(no folder)"
        },
        "Status": "active"
      },
      {
        "Name": "domain-exp141.com",
        "Expiration": "1361430589062",
        "Registration": "1234567890123",
        "NameServerSettings": {
          "Type": "Dynadot Parking",
          "WithAds": "Yes"
        },
        "Whois": {
          "Registrant": {
            "ContactId": "1"
          },
          "Admin": {
            "ContactId": "2"
          },
          "Technical": {
            "ContactId": "3"
          },
          "Billing": {
            "ContactId": "4"
          }
        },
        "Locked": "yes",
        "Disabled": "no",
        "UdrpLocked": "no",
        "RegistrantUnverified": "no",
        "Hold": "no",
        "Privacy": "none",
        "isForSale": "no",
        "RenewOption": "no renew option",
        "Note": "",
        "Folder": {
          "FolderId": "-1",
          "FolderName": "(no folder)"
        },
        "Status": "moved"
      }
    ]
  }
}
 

Comando di blocco dominio

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando lock domain, è necessario includere i seguenti parametri:

Parametro della richiesta di blocco del dominio
Spiegazione
domainIl nome del dominio che vuoi bloccare, è possibile inserire solo 1 dominio per richiesta
Tag XML del risultato
Spiegazione
<LockDomainResponse></LockDomainResponse>Nodo radice del documento XML di risposta documento XML
<LockDomainHeader></LockDomainHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di blocco del dominio

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=lock_domain&domain=domain4.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=lock_domain&domain=domain4.com
Risposta (formato XML)
<LockDomainResponse>
   <LockDomainHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </LockDomainHeader>
</LockDomainResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=lock_domain&domain=domain4.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=lock_domain&domain=domain4.com
Risposta (formato JSON)
{
   "LockDomainResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando di ricerca suggerimenti

Supporto multi-thread
Supporta API Sandbox

La chiamata al comando di ricerca suggerimenti acquisterà il nome di dominio specificato. Questo comando è disponibile solo nei formati XML e JSON. Se si chiama questo comando, è necessario includere i seguenti parametri:

Parametro della richiesta di ricerca suggerimenti
Spiegazione
domainIl dominio che vuoi cercare, è possibile inserire solo 1 dominio per richiesta
tlds (optional)I TLD che il risultato della ricerca deve contenere esclusivamente
Tag XML del risultato
Spiegazione
<SuggestionSearchResponse></SuggestionSearchResponse>Tag della risposta di ricerca suggerimenti, è il nodo radice del documento XML di risposta
<SuggestionSearchHeader></SuggestionSearchHeader>Intestazione della ricerca suggerimenti
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di ricerca di suggerimenti

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=suggestion_search&domain=domain.com&action=com,net
Richiesta Sandbox (formato XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=suggestion_search&domain=domain.com&action=com,net
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SuggestionSearchResponse>
  <SuggestionSearchHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SuggestionSearchHeader>
  <SuggestionSearchContent>
    <SuggestionSearch>
      <Domain>test1.com</Domain>
      <Domain>test2.com</Domain>
      <Domain>test3.net</Domain>
      <Domain>test4.net</Domain>
    </SuggestionSearch>
  </SuggestionSearchContent>
</SuggestionSearchResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=suggestion_search&domain=domain.com&action=com,net
Richiesta Sandbox (formato JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=suggestion_search&domain=domain.com&action=com,net
Risposta (formato JSON)
{
  "SuggestionSearchResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Domains": [
      "test1.com",
      "test2.com",
      "test3.net",
      "test4.net"
    ]
  }
}
 

Comando Annulla trasferimento

Supporto multi-thread
Supporta API Sandbox

Il comando permette di annullare una voce di trasferimento nell'ordine. Se si chiama il comando di annullamento trasferimento, è necessario includere i seguenti parametri:

Parametro della richiesta di annullamento del trasferimento
Spiegazione
domainIl nome di dominio per cui vuoi annullare il trasferimento, è possibile inserire solo 1 dominio per richiesta
order_idL'ID dell'ordine di trasferimento, puoi ottenerlo da un'altra API get_transfer_status.
Tag XML del risultato
Spiegazione
<CancelTransferResponse></CancelTransferResponse>Nodo radice del documento XML di risposta documento XML
<CancelTransferHeader></CancelTransferHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di annullamento del trasferimento

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=cancel_transfer&domain=domain4.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=cancel_transfer&domain=domain4.com
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<CancelTransferResponse>
  <CancelTransferHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </CancelTransferHeader>
</CancelTransferResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=cancel_transfer&domain=domain4.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=cancel_transfer&domain=domain4.com
Risposta (formato JSON)
{
  "CancelTransferResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

Comando per ottenere lo stato del trasferimento

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando get transfer status, è necessario includere i seguenti parametri:

Parametro di richiesta stato trasferimento
Spiegazione
domainIl nome di dominio per cui vuoi ottenere lo stato di trasferimento; è possibile inserire solo 1 dominio per richiesta
transfer_typeIl tipo di trasferimento per cui vuoi ottenere lo stato (trasferimento in entrata o trasferimento in uscita)
Tag XML del risultato
Spiegazione
<GetTransferStatusResponse></GetTransferStatusResponse>Nodo radice del documento XML di risposta documento XML
<GetTransferStatusHeader></GetTransferStatusHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetTransferStatusContent></GetTransferStatusContent>Contenuto della risposta
<TransferList></TransferList>Elenco trasferimenti
<Transfer></Transfer>Informazioni sul trasferimento
<OrderId></OrderId>L'ID dell'ordine
<TransferStatus></TransferStatus>Lo stato di trasferimento del dominio. Se hai 'none' o 'approved', puoi annullare il trasferimento. Se hai 'waiting', significa che il trasferimento è già iniziato. Se hai 'auth code needed', significa che il codice di autorizzazione non è valido; puoi usare un'altra API SET_TRANSFER_AUTH per reinviare il codice di autorizzazione. Ci sono anche altri stati; ti invieremo un'email o dovranno essere verificati dai nostri ingegneri.

Esempio di ottenimento dello stato di trasferimento

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetTransferStatusResponse>
  <GetTransferStatusHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetTransferStatusHeader>
  <GetTransferStatusContent>
    <TransferList>
      <Transfer>
        <OrderId>testorderid</OrderId>
        <TransferStatus>teststatus</TransferStatus>
      </Transfer>
      <Transfer>
        <OrderId>testorderid2</OrderId>
        <TransferStatus>teststatus2</TransferStatus>
      </Transfer>
    </TransferList>
  </GetTransferStatusContent>
</GetTransferStatusResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
Risposta (formato JSON)
{
  "GetTransferStatusResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "TransferList": [
      {
        "OrderId": "testorderid",
        "TransferStatus": "teststatus"
      },
      {
        "OrderId": "testorderid2",
        "TransferStatus": "teststatus2"
      }
    ]
  }
}
 

Imposta il codice di autenticazione del trasferimento per il comando Transfer Order

Supporto multi-thread
Supporta API Sandbox

Il comando che consente di aggiornare il codice di autorizzazione per elaborare gli ordini di trasferimento. Se chiami il comando set transfer auth code, i seguenti parametri dovrebbero essere inclusi:

Imposta parametro di richiesta per il codice di autorizzazione al trasferimento
Spiegazione
domainIl nome di dominio per cui aggiorni l'autorizzazione al trasferimento, è possibile inserire solo 1 dominio per richiesta
auth_codeL'auth_code che vuoi inviare di nuovo
order_idL'ID dell'ordine di trasferimento, puoi ottenerlo da un'altra API get_transfer_status.
Tag XML del risultato
Spiegazione
<GetTransferStatusResponse></GetTransferStatusResponse>Nodo radice del documento XML di risposta documento XML
<GetTransferStatusHeader></GetTransferStatusHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione del codice di autorizzazione del trasferimento

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
Risposta (formato XML)
<SetTransferAuthCodeResponse>
   <SetTransferAuthCodeHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </SetTransferAuthCodeHeader>
</SetTransferAuthCodeResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
Risposta (formato JSON)
{
   "SetTransferAuthCodeResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Autorizza trasferimento in uscita

Supporto multi-thread
Supporta API Sandbox
Parametro della richiesta di autorizzazione al trasferimento in uscita
Spiegazione
domainIl nome di dominio per cui vuoi autorizzare il trasferimento in uscita, è possibile inserire solo 1 dominio per richiesta
order_idL'order_id Dynadot del dominio che vuoi trasferire altrove
authorizePer autorizzare il trasferimento in uscita, impostalo su "approve". Per negare il trasferimento in uscita, impostalo su "deny".
Tag XML del risultato
Spiegazione
<AuthorizeTransferAwayResponse></AuthorizeTransferAwayResponse>Nodo radice del documento XML di risposta documento XML
<AuthorizeTransferAwayHeader></AuthorizeTransferAwayHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<Result></Result>Il risultato dell'autorizzazione al trasferimento in uscita

Esempio di autorizzazione al trasferimento in uscita

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<AuthorizeTransferAwayResponse>
  <AuthorizeTransferAwayHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
    <Result>away_approved</Result>
  </AuthorizeTransferAwayHeader>
</AuthorizeTransferAwayResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
Risposta (formato JSON)
{
  "AuthorizeTransferAwayResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Result": "away_approved"
  }
}
 

Comando per ottenere il codice di autorizzazione al trasferimento

Supporto multi-thread
Supporta API Sandbox

Devi sbloccare il tuo dominio e il tuo account prima di richiedere il codice di autorizzazione.

Parametro della richiesta per ottenere il codice di autorizzazione al trasferimento
Spiegazione
domainIl nome di dominio per cui vuoi ottenere il codice di autorizzazione per il trasferimento, è possibile inserire solo 1 dominio per richiesta
new_code (optional)Genera un nuovo codice di autorizzazione al trasferimento
unlock_domain_for_transfer (Optional. Requires api skip lock agreement to use)Se vuoi sbloccare il dominio per il trasferimento, impostalo uguale a "1". Se la richiesta viene elaborata con successo, il dominio verrà sbloccato.
Tag XML del risultato
Spiegazione
<GetTransferAuthCodeResponse></GetTransferAuthCodeResponse>Nodo radice del documento XML di risposta documento XML
<GetTransferAuthCodeHeader></GetTransferAuthCodeHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<AuthCode></AuthCode>Il codice di autorizzazione viene utilizzato per avviare un trasferimento di dominio.

Esempio di ottenimento del codice di autorizzazione al trasferimento

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetTransferAuthCodeResponse>
  <GetTransferAuthCodeHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
    <AuthCode>testauthcode</AuthCode>
  </GetTransferAuthCodeHeader>
</GetTransferAuthCodeResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
Risposta (formato JSON)
{
  "GetTransferAuthCodeResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "AuthCode": "testauthcode"
  }
}
 

Comando per ottenere la richiesta di push del dominio

Supporto multi-thread
Supporta API Sandbox

Chiamando il comando Get Domain Push Request otterrai la richiesta di push del dominio. Questo comando è disponibile solo in formato XML e JSON.

Parametro della richiesta Get Domain Push Request
Spiegazione
N/A Nessun parametro aggiuntivo necessario
Tag XML del risultato
Spiegazione
<GetDomainPushRequestResponse></GetDomainPushRequestResponse>il nodo radice della risposta
<GetDomainPushRequestHeader></GetDomainPushRequestHeader>Intestazione della richiesta Get Domain Push
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetDomainPushRequestContent></GetDomainPushRequestContent>contenuto della risposta
<PushDomain></PushDomain>Trasferisci dominio
<PushDomainName></PushDomainName>Push del nome di dominio

Esempio di richiesta di push del dominio

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_domain_push_request
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_domain_push_request
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetDomainPushRequestResponse>
  <GetDomainPushRequestHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetDomainPushRequestHeader>
  <GetDomainPushRequestContent>
    <PushDomain>
      <PushDomainName>haha.com</PushDomainName>
    </PushDomain>
    <PushDomain>
      <PushDomainName>haha1.com</PushDomainName>
    </PushDomain>
  </GetDomainPushRequestContent>
</GetDomainPushRequestResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_domain_push_request
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_domain_push_request
Risposta (formato JSON)
{
  "GetDomainPushRequestResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "pushDomainName": "[haha.com,haha1.com]"
  }
}
 

Comando Imposta richiesta di push del dominio

Supporto multi-thread
Supporta API Sandbox

La chiamata del comando Set Domain Push Request imposterà la richiesta di push del dominio. Questo comando è disponibile solo in formato XML e JSON. Se si chiama questo comando, è necessario includere i seguenti parametri:

Imposta parametro di richiesta push dominio
Spiegazione
domainsIl nome di dominio dell'ordine da elaborare
actionL'azione dell'ordine da elaborare, puoi scegliere "accept" o "decline"
Tag XML del risultato
Spiegazione
<SetDomainPushRequestResponse></SetDomainPushRequestResponse>il nodo radice della risposta
<SetDomainPushRequestHeader></SetDomainPushRequestHeader>Header della richiesta Set Domain Push
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di richiesta push dominio

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetDomainPushRequestResponse>
  <SetDomainPushRequestHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetDomainPushRequestHeader>
  <SetDomainPushRequestContent/>
</SetDomainPushRequestResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
Risposta (formato JSON)
{
  "SetDomainPushRequestResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

Comando Create CN Audit

Supporto multi-thread
Supporta API Sandbox

Il comando ti consente di creare un audit CN per un contatto. Se chiami il comando create cn audit, i seguenti parametri dovrebbero essere inclusi:

Parametro della richiesta di creazione audit CN
Spiegazione
contact_idL'ID del record contatto per cui vuoi avviare l'audit; puoi inserire solo 1 ID contatto per richiesta
contact_typeTipo di contatto, può essere "Individual" o "Enterprise"
individual_id_typeTipo di ID di persona fisica, i valori attesi (descrizione del valore) sono:
JGZ (carta d'identità di ufficiale della Repubblica Popolare Cinese)
SFZ (carta d'identità della Repubblica Popolare Cinese)
HZ (Passaporto)
GAJMTX (Permesso di uscita e ingresso per viaggi da e verso Hong Kong e Macao)
TWJMTX (Permessi di viaggio per i residenti di Taiwan per entrare o uscire dalla Cina continentale)
WJLSFZ (Carta di residenza permanente per stranieri della Repubblica Popolare Cinese)
GAJZZ (Permesso di soggiorno per Hong Kong, Macao)
TWJZZ (Permesso di soggiorno per residenti taiwanesi)
QT (Altri)
individual_license_idIl numero di licenza dell'ID della persona fisica
individual_urlDocumento di licenza ID di persona fisica. L'URL del file sul server. Sono consentiti solo jpg, gif, png, jpeg
enterprise_id_type (Mandatory when contact type is "Enterprise")Tipo di Enterprise ID, i valori previsti (descrizione del valore) sono:
ORG (Certificato del codice di organizzazione)
YYZZ (Licenza commerciale)
TYDM (Certificato per il codice unificato di credito sociale)
BDDM (Designazione del codice militare)
JDDWFW (Licenza per servizio esterno a pagamento militare)
SYDWFR (Certificato di persona giuridica di istituzione pubblica)
WGCZJG (Modulo di registrazione degli uffici di rappresentanza residenti delle imprese straniere)
SHTTFR (Certificato di registrazione della persona giuridica dell'organizzazione sociale)
ZJCS (Certificato di registrazione del sito per attività religiose)
MBFQY (Certificato di registrazione per entità privata non imprenditoriale)
JJHFR (Certificato di registrazione della persona giuridica del fondo)
LSZY (Licenza di esercizio dello studio legale)
WGZHWH (Certificato di registrazione del Centro Culturale Straniero in Cina)
WLCZJG (Certificato di approvazione e registrazione dell'Ufficio di rappresentanza residente dei Dipartimenti del Turismo di Governi esteri)
SFJD (Licenza di Perizia Giudiziaria)
JWJG (Certificato di organizzazione estera)
SHFWJG (Certificato di registrazione dell'agenzia di servizi sociali)
MBXXBX (Autorizzazione per scuola privata)
YLJGZY (Licenza di esercizio per istituzioni mediche)
GZJGZY (Licenza di esercizio per organizzazione notarile)
BJWSXX (Permesso della Scuola di Pechino per i figli del personale delle ambasciate straniere in Cina)
QTTYDM (Altri-Certificato per Codice Unificato di Credito Sociale)
QT (Altri)
enterprise_license_id (Mandatory when contact type is "Enterprise")Il numero di licenza del documento aziendale
enterprise_url (Mandatory when contact type is "Enterprise")Documento di licenza enterprise. L'URL del file sul server. Sono consentiti solo jpg, gif, png, jpeg
Tag XML del risultato
Spiegazione
<CreateCnAuditResponse></CreateCnAuditResponse>Nodo radice del documento XML di risposta
<CreateCnAuditHeader></CreateCnAuditHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Crea esempio di audit Cn

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<CreateCnAuditResponse>
  <CreateCnAuditHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </CreateCnAuditHeader>
</CreateCnAuditResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
Risposta (formato JSON)
{
  "CreateCnAuditResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

Comando Ottieni stato di verifica Cn

Supporto multi-thread
Supporta API Sandbox

Se chiami il comando get cn audit status, i seguenti parametri dovrebbero essere inclusi:

Parametro della richiesta per ottenere lo stato di audit Cn
Spiegazione
contact_idL'ID del record di contatto per cui si desidera ottenere lo stato di audit, è possibile inserire solo 1 contactId per richiesta.
gtldSe consulti il risultato dell'audit di cnnic-gtld, imposta questo parametro a 1
Tag XML del risultato
Spiegazione
<GetCnAuditStatusResponse></GetCnAuditStatusResponse>Nodo radice del documento XML di risposta documento XML
<GetCnAuditStatusHeader></GetCnAuditStatusHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<CnAuditStatus></CnAuditStatus>lo stato di audit del record di audit cnnic. Potresti ricevere 'processing' o 'waiting for cnnic' o 'failed'. Se fallisce, ti invieremo un'email.
<FailedReason></FailedReason>Se l'audit non è superabile, verrà visualizzato il motivo del fallimento

Esempio di recupero dello stato di audit Cn

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_cn_audit_status&contact_id=testcontactid
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_cn_audit_status&contact_id=testcontactid
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetCnAuditStatusResponse>
  <GetCnAuditStatusHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
    <CnAuditStatus>pass</CnAuditStatus>
  </GetCnAuditStatusHeader>
</GetCnAuditStatusResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_cn_audit_status&contact_id=testcontactid
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_cn_audit_status&contact_id=testcontactid
Risposta (formato JSON)
{
  "GetCnAuditStatusResponse": {
    "ResponseCode": "0",
    "Status": "success",
    "CnAuditStatus": "pass"
  }
}
 

Comando Crea Contatto

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando create contact, occorre includere i seguenti parametri:

Parametro della richiesta di creazione contatto
Spiegazione
organization (optional)Le informazioni sull'organizzazione
nameTermine
emailEmail
phonenumNumero di telefono
phoneccPrefisso internazionale telefono
faxnum (optional)Numero di fax
faxcc (optional)Codice paese fax
address1Indirizzo1
address2 (optional)Indirizzo 2
cityCittà
state (optional)Stato
zipCodice postale
countryPaese
Tag XML del risultato
Spiegazione
<CreateContactResponse></CreateContactResponse>Nodo radice del documento XML di risposta
<CreateContactHeader></CreateContactHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<CreateContactContent></CreateContactContent>Nuovo ID contatto, usato solo quando lo stato è "success"

Esempio di creazione contatto

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=create_contact&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=create_contact&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
Risposta (formato XML)
<CreateContactResponse>
  <CreateContactHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </CreateContactHeader>
  <CreateContactContent>
    <ContactId>1234</ContactId>
  </CreateContactContent>
</CreateContactResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=create_contact&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=create_contact&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
Risposta (formato JSON)
{
   "CreateContactResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "CreateContactContent":{
         "ContactId":"0"
      }
   }
}
 

Comando Modifica Contatto

Supporto multi-thread
Supporta API Sandbox

Se chiami il comando edit contact, dovresti includere i seguenti parametri:

Parametro richiesta modifica contatto
Spiegazione
contact_idL'ID del contatto che vuoi modificare
organization (optional)Le informazioni sull'organizzazione
nameTermine
emailEmail
phonenumNumero di telefono
phoneccPrefisso internazionale telefono
faxnum (optional)Numero di fax
faxcc (optional)Codice paese fax
address1Indirizzo 1
address2 (optional)Indirizzo 2
cityCittà
stateStato
zipCodice postale
countryPaese
Tag XML del risultato
Spiegazione
<EditContactResponse></EditContactResponse>Nodo radice del documento XML di risposta
<EditContactHeader></EditContactHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<EditContactContent></EditContactContent>Contenuto della risposta
<ContactId></ContactId>ID del contatto

Esempio di modifica contatto

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<EditContactResponse>
  <EditContactHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </EditContactHeader>
  <EditContactContent>
    <ContactId>0</ContactId>
  </EditContactContent>
</EditContactResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
Risposta (formato JSON)
{
  "EditContactResponse": {
    "ResponseCode": "0",
    "Status": "success",
    "EditContactContent": {
      "ContactId": "0"
    }
  }
}
Richiesta (formato CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
Richiesta Sandbox (formato CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
Risposta (formato CSV)
ok,

success,
,
 

Comando Elimina Contatto

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando delete contact, i seguenti parametri devono essere inclusi:

Parametro della richiesta di eliminazione contatto
Spiegazione
contact_idL'ID del contatto che vuoi eliminare, assicurati che siano separati da virgole
Tag XML del risultato
Spiegazione
<DeleteContactResponse></DeleteContactResponse>Nodo radice del documento XML di risposta
<DeleteContactHeader></DeleteContactHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di eliminazione contatto

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_contact&contact_id=0
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete_contact&contact_id=0
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteContactResponse>
  <DeleteContactHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteContactHeader>
</DeleteContactResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_contact&contact_id=0
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete_contact&contact_id=0
Risposta (formato JSON)
{
  "DeleteContactResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

Comando elenco contatti

Supporto multi-thread
Supporta API Sandbox

Questo comando è disponibile solo nei formati XML e JSON:

Parametro della richiesta di elenco contatti
Spiegazione
N/ANessun parametro aggiuntivo necessario
Tag XML del risultato
Spiegazione
<ContactListResponse></ContactListResponse>Nodo radice del documento XML di risposta
<ContactListHeader></ContactListHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<ContactListContent></ContactListContent>Contenuto della risposta
<ContactList></ContactList>Elenco contatti
<Contact></Contact>Informazioni di contatto
<ContactId></ContactId>ID Contatto
<Organization></Organization>Organizzazione del contatto
<Name></Name>Termine
<Email></Email>Email
<PhoneCc></PhoneCc>Prefisso internazionale telefono
<PhoneNum></PhoneNum>Numero di telefono
<FaxCc></FaxCc>Codice paese fax
<FaxNum></FaxNum>Numero di fax
<Address1></Address1>Indirizzo 1
<Address2></Address2>Indirizzo 2
<City></City>Città
<State></State>Stato
<ZipCode></ZipCode>Codice postale
<Country></Country>Paese
<GtldVerified></GtldVerified>Stato di verifica gTLD

Esempio di elenco contatti

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=contact_list
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=contact_list
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<ContactListResponse>
  <ContactListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ContactListHeader>
  <ContactListContent>
    <ContactList>
      <Contact>
        <ContactId>0</ContactId>
        <Organization/>
        <Name>Jack tester</Name>
        <Email></Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>555.555.5233</PhoneNum>
        <FaxCc/>
        <FaxNum/>
        <Address1>test street</Address1>
        <Address2/>
        <City>Los Angeles</City>
        <State>CA</State>
        <ZipCode>90068</ZipCode>
        <Country>US</Country>
        <GtldVerified>no</GtldVerified>
      </Contact>
      <Contact>
        <ContactId>1</ContactId>
        <Organization/>
        <Name>John tester</Name>
        <Email></Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>123.456.7890</PhoneNum>
        <FaxCc>1</FaxCc>
        <FaxNum>123.456.7890</FaxNum>
        <Address1>high Way first</Address1>
        <Address2/>
        <City>San Francisco</City>
        <State>CA</State>
        <ZipCode>90068</ZipCode>
        <Country>US</Country>
        <GtldVerified>yes</GtldVerified>
      </Contact>
    </ContactList>
  </ContactListContent>
</ContactListResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=contact_list
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=contact_list
Risposta (formato JSON)
{
  "ContactListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "ContactList": [
      {
        "ContactId": "0",
        "Organization": "",
        "Name": "Jack tester",
        "Email": "",
        "PhoneCc": "1",
        "PhoneNum": "555.555.5233",
        "FaxCc": "",
        "FaxNum": "",
        "Address1": "test street",
        "Address2": "",
        "City": "Los Angeles",
        "State": "CA",
        "ZipCode": "90068",
        "Country": "US",
        "GtldVerified": "no"
      },
      {
        "ContactId": "1",
        "Organization": "",
        "Name": "John tester",
        "Email": "",
        "PhoneCc": "1",
        "PhoneNum": "123.456.7890",
        "FaxCc": "1",
        "FaxNum": "123.456.7890",
        "Address1": "high Way first",
        "Address2": "",
        "City": "San Francisco",
        "State": "CA",
        "ZipCode": "90068",
        "Country": "US",
        "GtldVerified": "yes"
      }
    ]
  }
}
 

Comando Ottieni contatto

Supporto multi-thread
Supporta API Sandbox

Questo comando è disponibile solo nei formati XML e JSON:

Parametro della richiesta Get Contact
Spiegazione
contact_idid del contatto
Tag XML del risultato
Spiegazione
<GetContactResponse></GetContactResponse>Nodo radice del documento XML di risposta
<GetContactHeader></GetContactHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetContactContent></GetContactContent>Contenuto della risposta
<Contact></Contact>Informazioni di contatto
<ContactId></ContactId>ID Contatto
<Organization></Organization>Organizzazione del contatto
<Name></Name>Termine
<Email></Email>Email
<PhoneCc></PhoneCc>Prefisso internazionale telefono
<PhoneNum></PhoneNum>Numero di telefono
<FaxCc></FaxCc>Codice paese fax
<FaxNum></FaxNum>Numero di fax
<Address1></Address1>Indirizzo 1
<Address2></Address2>Indirizzo 2
<City></City>Città
<State></State>Stato
<ZipCode></ZipCode>Codice postale
<Country></Country>Paese
<GtldVerified></GtldVerified>Stato di verifica gTLD

Esempio di recupero contatto

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_contact&contact_id=10000
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_contact&contact_id=10000
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetContactResponse>
  <GetContactHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetContactHeader>
  <GetContactContent>
    <GetContact>
      <Contact>
        <ContactId>12345</ContactId>
        <Organization>org</Organization>
        <Name>name</Name>
        <Email></Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>555.555.5233</PhoneNum>
        <FaxCc/>
        <FaxNum/>
        <Address1>address1</Address1>
        <Address2>address2</Address2>
        <City>city</City>
        <State>state</State>
        <ZipCode>zipcode</ZipCode>
        <Country>country</Country>
        <GtldVerified>no</GtldVerified>
      </Contact>
    </GetContact>
  </GetContactContent>
</GetContactResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_contact&contact_id=10000
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_contact&contact_id=10000
Risposta (formato JSON)
{
  "GetContactResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "GetContact": {
      "ContactId": "12345",
      "Organization": "org",
      "Name": "name",
      "Email": "",
      "PhoneCc": "1",
      "PhoneNum": "555.555.5233",
      "FaxCc": "",
      "FaxNum": "",
      "Address1": "address1",
      "Address2": "address2",
      "City": "city",
      "State": "state",
      "ZipCode": "zipcode",
      "Country": "country",
      "GtldVerified": "no"
    }
  }
}
 

Comando Imposta impostazione contatto UE

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set contact eu setting, è necessario includere i seguenti parametri:

Parametro di richiesta per l'impostazione del contatto UE
Spiegazione
contact_idL'ID del contatto che vuoi modificare
country_of_citizenshipDeve essere uno stato membro dell'UE, i codici paese degli stati membri includono :
AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IS, IE, IT, LV, LI, LT, LU, MT, NL, NO, PL, PT, RO, SK, SI, ES, SE
Tag XML del risultato
Spiegazione
<SetContactEUSettingResponse></SetContactEUSettingResponse>Nodo radice del documento XML di risposta
<SetContactEUSettingHeader></SetContactEUSettingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<SetContactEUSettingContent></SetContactEUSettingContent>Contenuto della risposta
<ContactId></ContactId>ID del contatto

Esempio di impostazione contatto UE

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetContactEUSettingResponse>
  <SetContactEUSettingHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetContactEUSettingHeader>
  <SetContactEUSettingContent>
    <ContactId>0</ContactId>
  </SetContactEUSettingContent>
</SetContactEUSettingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
Risposta (formato JSON)
{
  "SetContactEUSettingResponse": {
    "ResponseCode: ": "0",
    "Status": "Success",
    "SetContactEUSettingContent": {
      "ContactId: ": "0"
    }
  }
}
 

Comando Imposta impostazione LV contatto

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set contact lv setting, occorre includere i seguenti parametri:

Imposta il parametro della richiesta di impostazione LV del contatto
Spiegazione
contact_idL'ID del contatto che vuoi modificare
registration_number- Per individui, inserisci il numero di identificazione lettone.
- Per aziende e altre entità legali, inserisci il numero di registrazione rilasciato dal Registro delle Imprese Lettone.
vat_number (optional)Partita IVA per entità giuridiche estere registrate nei paesi dell'Unione Europea (include anche le aziende lettoni)
Tag XML del risultato
Spiegazione
<SetContactLvSettingResponse></SetContactLvSettingResponse>Nodo radice del documento XML di risposta
<SetContactLvSettingHeader></SetContactLvSettingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<SetContactLvSettingContent></SetContactLvSettingContent>Contenuto della risposta
<ContactId></ContactId>ID del contatto

Esempio di impostazione Set Contact Lv

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetContactLvSettingResponse>
  <SetContactLvSettingHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetContactLvSettingHeader>
  <SetContactLvSettingContent>
    <ContactId>0</ContactId>
  </SetContactLvSettingContent>
</SetContactLvSettingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number
Risposta (formato JSON)
{
  "SetContactLvSettingResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "SetContactLvSettingContent": {
      "ContactId: ": "0"
    }
  }
}

Esempio di impostazione del contatto LV

Richiesta (formato CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number
Richiesta Sandbox (formato CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number
Risposta (formato CSV)
ok,success,0
 

Comando Imposta impostazioni LT contatto

Supporto multi-thread
Supporta API Sandbox

Se chiami il comando Imposta impostazioni LT contatto, è necessario includere i seguenti parametri:

Parametro della richiesta Imposta impostazioni LT contatto
Spiegazione
contact_idL'ID del contatto che vuoi modificare
organization_codePuoi impostare il codice dell'organizzazione del contatto solo dopo che l'organizzazione del contatto è stata impostata.
Tag XML del risultato
Spiegazione
<SetContactLtSettingResponse></SetContactLtSettingResponse>Nodo radice del documento XML di risposta
<SetContactLtSettingHeader></SetContactLtSettingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<SetContactLtSettingContent></SetContactLtSettingContent>Contenuto della risposta
<ContactId></ContactId>ID del contatto

Esempio di Imposta impostazioni LT contatto

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_contact_lt_setting&contact_id=0&organization_code=testing_organization_code
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_contact_lt_setting&contact_id=0&organization_code=testing_organization_code
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetContactLtSettingResponse>
  <SetContactLtSettingHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetContactLtSettingHeader>
  <SetContactLtSettingContent>
    <ContactId>0</ContactId>
  </SetContactLtSettingContent>
</SetContactLtSettingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_contact_lt_setting&contact_id=0&organization_code=testing_organization_code
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_contact_lt_setting&contact_id=0&organization_code=testing_organization_code
Risposta (formato JSON)
{
  "SetContactLtSettingResponse": {
    "ResponseCode:": "0",
    "Status": "Success",
    "SetContactLtSettingContent": {
      "ContactId": "0"
    }
  }
}
 

Comando Get Name Server

Supporto multi-thread
Supporta API Sandbox

Se chiami il comando get name server, devono essere inclusi i seguenti parametri:

Parametro della richiesta Get Name Server
Spiegazione
domainIl dominio di cui vuoi ottenere le informazioni sui name server, è possibile recuperare le informazioni sui name server di un solo dominio per richiesta.
Tag XML del risultato
Spiegazione
<GetNsResponse></GetNsResponse>Nodo radice del documento XML di risposta
<GetNsHeader></GetNsHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<NsContent></NsContent>Contenuto della risposta
<Host></Host>Nome host del server
<NsName></NsName>Nome del server

Ottieni esempio Ns

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_ns&domain=mydomain.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_ns&domain=mydomain.com
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetNsResponse>
  <GetNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetNsHeader>
  <NsContent>
    <Host>ns1.mydomain.com</Host>
    <Host>ns2.mydomain.com</Host>
  </NsContent>
</GetNsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_ns&domain=mydomain.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_ns&domain=mydomain.com
Risposta (formato JSON)
{
  "GetNsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "NsContent": {
      "Host0": "ns1.mydomain.com",
      "Host1": "ns2.mydomain.com"
    }
  }
}
 

Comando Aggiungi Name Server

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando add name server, è necessario includere i seguenti parametri:

Parametro della richiesta di aggiunta del server dei nomi
Spiegazione
hostIl nome host del name server che vuoi aggiungere
Tag XML del risultato
Spiegazione
<AddNsResponse></AddNsResponse>Nodo radice del documento XML di risposta
<AddNsHeader></AddNsHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<AddNsContent></AddNsContent>Contenuto della risposta
<Server></Server>Server che hai impostato
<Host></Host>Nome host del nuovo server
<ServerId></ServerId>ID del nuovo server

Esempio di aggiunta NS

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=add_ns&host=ns1.mydomain.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=add_ns&host=ns1.mydomain.com
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<AddNsResponse>
  <AddNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </AddNsHeader>
  <AddNsContent>
    <Server>
      <Host>ns1.mydomain.com</Host>
      <ServerId>0</ServerId>
    </Server>
  </AddNsContent>
</AddNsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=add_ns&host=ns1.mydomain.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=add_ns&host=ns1.mydomain.com
Risposta (formato JSON)
{
  "AddNsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "AddNsContent": {
      "Server": {
        "Host": "ns1.mydomain.com",
        "ServerId": 0
      }
    }
  }
}
 

Comando registrazione name server

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando register name server, è necessario includere i seguenti parametri:

Parametro della richiesta di registrazione del name server
Spiegazione
hostIl nome host del tuo name server
ipL'indirizzo IP del tuo name server
Tag XML del risultato
Spiegazione
<RegisterNsResponse></RegisterNsResponse>Nodo radice del documento XML di risposta
<RegisterNsHeader></RegisterNsHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<RegisterNsContent></RegisterNsContent>Contenuto della risposta
<Server></Server>Tag del server
<Host></Host>Nome host
<ServerId></ServerId>ID server

Esempio di registrazione Name Server

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
Risposta (formato XML)
<RegisterNsResponse>
  <RegisterNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RegisterNsHeader>
  <RegisterNsContent>
    <Server>
      <Host>domain1.com</Host>
      <ServerId>0</ServerId>
    </Server>
  </RegisterNsContent>
</RegisterNsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
Risposta (formato JSON)
{
   "RegisterNsResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "RegisterNsContent":{
         "Server":{
            "Host":"ndomain1.com",
            "ServerId":"0"
         }
      }
   }
}
 

Comando per impostare l'IP del name server

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set name server IP, è necessario includere i seguenti parametri:

Parametro di richiesta per impostare l'IP del Name Server
Spiegazione
server_idL'ID del name server che vuoi impostare
ip0 - ip9L'indirizzo IP che vuoi impostare per il name server, è possibile impostare 9 IP per richiesta e devono essere separati da virgole
Tag XML del risultato
Spiegazione
<SetNsIpResponse></SetNsIpResponse>Nodo radice del documento XML di risposta
<SetNsIpHeader></SetNsIpHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione IP del name server

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
Risposta (formato XML)
<SetNsIpResponse>
  <SetNsIpHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetNsIpHeader>
</SetNsIpResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
Risposta (formato JSON)
{
   "SetNsIpResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando di eliminazione del Name Server

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando delete name server, i seguenti parametri devono essere inclusi:

Parametro della richiesta di eliminazione del Name Server
Spiegazione
server_idL'ID dei name server che vuoi eliminare, assicurati che siano separati da virgole
Tag XML del risultato
Spiegazione
<DeleteNsResponse></DeleteNsResponse>Nodo radice del documento XML di risposta
<DeleteNsHeader></DeleteNsHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di eliminazione Ns

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_ns&server_id=0
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete_ns&server_id=0
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteNsResponse>
  <DeleteNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteNsHeader>
</DeleteNsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_ns&server_id=0
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete_ns&server_id=0
Risposta (formato JSON)
{
  "DeleteNsResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

Comando Elimina Name Server per Dominio

Supporto multi-thread
Supporta API Sandbox

Se si richiama il comando delete name server per dominio, i seguenti parametri devono essere inclusi:

Elimina Name Server tramite parametro di richiesta del dominio
Spiegazione
server_domainNome del name server. es: ns1.testnameserver.com
Tag XML del risultato
Spiegazione
<DeleteNsResponse></DeleteNsResponse>Nodo radice del documento XML di risposta
<DeleteNsHeader></DeleteNsHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di eliminazione del name server per dominio

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
Risposta (formato XML)
<DeleteNsResponse>
  <DeleteNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteNsHeader>
</DeleteNsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
Risposta (formato JSON)
{
   "DeleteNsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Elenco Server

Supporto multi-thread
Supporta API Sandbox

Questo comando è disponibile solo nei formati XML e JSON:

Parametro di richiesta elenco server
Spiegazione
N/ANessun parametro aggiuntivo necessario
Tag XML del risultato
Spiegazione
<ServerListResponse></ServerListResponse>Nodo radice del documento XML di risposta
<ServerListHeader></ServerListHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<ServerListContent></ServerListContent>Contenuto della risposta
<NameServerList></NameServerList>Elenco dei name server
<List></List>
<Server></Server>
<ServerId></ServerId>ID server
<ServerName></ServerName>Nome del server
<ServerIp></ServerIp>IP del server

Esempio di elenco server

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=server_list
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=server_list
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<ServerListResponse>
  <ServerListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ServerListHeader>
  <ServerListContent>
    <NameServerList>
      <List>
        <Server>
          <ServerId>0</ServerId>
          <ServerName>ns1.com</ServerName>
        </Server>
        <Server>
          <ServerId>1</ServerId>
          <ServerName>domain1.com</ServerName>
          <ServerIp>192.168.1.1</ServerIp>
          <ServerIp>1.1.1.1</ServerIp>
        </Server>
      </List>
    </NameServerList>
  </ServerListContent>
</ServerListResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=server_list
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=server_list
Risposta (formato JSON)
{
  "ServerListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "ServerList": [
      {
        "ServerId": "0",
        "ServerName": "ns1.com"
      },
      {
        "ServerId": "1",
        "ServerName": "domain1.com",
        "ServerIps": [
          {
            "Ip": "192.168.1.1"
          },
          {
            "Ip": "1.1.1.1"
          }
        ]
      }
    ]
  }
}
 

Comando per ottenere le impostazioni del NameServer del dominio

Supporto multi-thread
Supporta API Sandbox

Se chiami il comando get domain nameservers settings, dovrebbero essere inclusi i seguenti parametri:

Parametro di richiesta per ottenere le impostazioni dei nameserver del dominio
Spiegazione
domainIl dominio di cui vuoi ottenere l'impostazione del name server; è possibile recuperare l'impostazione del name server di un solo dominio per richiesta.
Tag XML del risultato
Spiegazione
<GetDnsResponse></GetDnsResponse>Nodo radice del documento XML di risposta
<GetDnsHeader></GetDnsHeader>Intestazione della risposta
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetDnsContent></GetDnsContent>Contenuto della risposta
<NameServerSettings></NameServerSettings>Impostazioni dei name server del dominio
<Type></Type>Tipo di nameserver del dominio

Esempio di recupero impostazioni nameserver del dominio

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_dns&domain=mydomain.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_dns&domain=mydomain.com
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetDnsResponse>
  <GetDnsHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetDnsHeader>
  <GetDnsContent>
    <NameServerSettings>
      <Type>Dynadot Parking</Type>
      <WithAds>Yes</WithAds>
    </NameServerSettings>
  </GetDnsContent>
</GetDnsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_dns&domain=mydomain.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_dns&domain=mydomain.com
Risposta (formato JSON)
{
  "GetDnsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "GetDns": {
      "NameServerSettings": {
        "Type": "Dynadot Parking",
        "WithAds": "Yes"
      }
    }
  }
}
 

Comando Informazioni Account

Supporto multi-thread
Supporta API Sandbox

Questo comando è disponibile solo nei formati XML e JSON:

Parametro di richiesta informazioni account
Spiegazione
N/ANessun parametro aggiuntivo necessario
Tag XML del risultato
Spiegazione
<AccountInfoResponse></AccountInfoResponse>Nodo radice del documento XML di risposta
<AccountInfoHeader></AccountInfoHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<AccountInfoContent></AccountInfoContent>Contenuto della risposta
<AccountInfo></AccountInfo>Informazioni account
<Username></Username>Nome utente
<ForumName></ForumName>Nome del forum
<Contact></Contact>Informazioni di contatto
<Organization></Organization>Organizzazione
<Organization></Organization>Intestazione della risposta
<Name></Name>Il tuo nome
<Email></Email>Email
<PhoneCc></PhoneCc>Prefisso internazionale telefono
<PhoneNum></PhoneNum>Numero di telefono
<Address1></Address1>Indirizzo 1
<Address2></Address2>Indirizzo 2
<City></City>Città
<State></State>Stato
<ZipCode></ZipCode>Codice postale
<Country></Country>Paese
<CustomerSince></CustomerSince>Cliente dal
<AccountLock></AccountLock>Blocco account
<TotalSpending></TotalSpending>Spesa totale
<PriceLevel></PriceLevel>Livello di prezzo
<AccountBalance></AccountBalance>Saldo del conto
<CustomTimeZone></CustomTimeZone>Fuso orario personalizzato
<DefaultSettings></DefaultSettings>Impostazioni predefinite
<DefaultWhois></DefaultWhois>Whois predefinito
<DefaultRegistrant></DefaultRegistrant>Registrante predefinito
<ContactId></ContactId>ID Contatto
<DefaultAdmin></DefaultAdmin>Amministratore predefinito
<DefaultTechnical></DefaultTechnical>Tecnico predefinito
<DefaultBilling></DefaultBilling>Fatturazione predefinita
<Type></Type>Tipo di name server
<WithAds></WithAds>Con pubblicità o no

Esempio di informazioni sull'account

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=account_info
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=account_info
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<AccountInfoResponse>
  <AccountInfoHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </AccountInfoHeader>
  <AccountInfoContent>
    <AccountInfo>
      <Username>testname</Username>
      <ForumName>test forum name</ForumName>
      <AvatarUrl>test avatar url</AvatarUrl>
      <Contact>
        <Organization/>
        <Name>testname test</Name>
        <Email></Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>555.555.5233</PhoneNum>
        <FaxCc/>
        <FaxNum/>
        <Address1>1 test road</Address1>
        <Address2/>
        <City>Los Angeles</City>
        <State>CA</State>
        <ZipCode>90000</ZipCode>
        <Country>US</Country>
      </Contact>
      <CustomerSince>1364888735253</CustomerSince>
      <AccountLock>on</AccountLock>
      <TotalSpending>$0.00</TotalSpending>
      <PriceLevel>Regular Pricing</PriceLevel>
      <AccountBalance>$70.02</AccountBalance>
      <CustomTimeZone>PST</CustomTimeZone>
      <DefaultSettings>
        <DefaultWhois>
          <DefaultRegistrant>
            <ContactId>0</ContactId>
          </DefaultRegistrant>
          <DefaultAdmin>
            <ContactId>0</ContactId>
          </DefaultAdmin>
          <DefaultTechnical>
            <ContactId>0</ContactId>
          </DefaultTechnical>
          <DefaultBilling>
            <ContactId>0</ContactId>
          </DefaultBilling>
        </DefaultWhois>
        <DefaultNameServerSettings>
          <Type>Dynadot Parking</Type>
          <WithAds>yes</WithAds>
        </DefaultNameServerSettings>
      </DefaultSettings>
    </AccountInfo>
  </AccountInfoContent>
</AccountInfoResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=account_info
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=account_info
Risposta (formato JSON)
{
  "AccountInfoResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "AccountInfo": {
      "Username": "testname",
      "ForumName": "test forum name",
      "AvatarUrl": "test avatar url",
      "Contact": {
        "Organization": "",
        "Name": "testname test",
        "Email": "",
        "PhoneCc": "1",
        "PhoneNum": "555.555.5233",
        "FaxCc": "",
        "FaxNum": "",
        "Address1": "1 test road",
        "Address2": "",
        "City": "Los Angeles",
        "State": "CA",
        "ZipCode": "90000",
        "Country": "US"
      },
      "CustomerSince": "1364888735253",
      "AccountLock": "on",
      "TotalSpending": "$0.00",
      "PriceLevel": "Regular Pricing",
      "AccountBalance": "$70.02",
      "CustomTimeZone": "PST",
      "DefaultSettings": {
        "DefaultWhois": {
          "DefaultRegistrant": {
            "ContactId": "0"
          },
          "DefaultAdmin": {
            "ContactId": "0"
          },
          "DefaultTechnical": {
            "ContactId": "0"
          },
          "DefaultBilling": {
            "ContactId": "0"
          }
        },
        "DefaultNameServerSettings": {
          "Type": "Dynadot Parking",
          "WithAds": "yes"
        }
      }
    }
  }
}
 

Comando per ottenere il saldo account

Supporto multi-thread
Supporta API Sandbox

Questo comando è disponibile solo nei formati XML e JSON:

Parametro della richiesta di ottenimento del saldo dell'account
Spiegazione
N/ANessun parametro aggiuntivo necessario
Tag XML del risultato
Spiegazione
<GetAccountBalanceResponse></GetAccountBalanceResponse>Nodo radice del documento XML di risposta documento XML
<GetAccountBalanceHeader></GetAccountBalanceHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetAccountBalanceContent></GetAccountBalanceContent>Contenuto della risposta
<Balance></Balance>Saldo del conto

Esempio di Get Account Balance

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_account_balance
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_account_balance
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetAccountBalanceResponse>
  <GetAccountBalanceHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetAccountBalanceHeader>
  <GetAccountBalanceContent>
    <BalanceList>
      <Balance>
        <Currency>USD</Currency>
        <Amount>300.00</Amount>
      </Balance>
    </BalanceList>
  </GetAccountBalanceContent>
</GetAccountBalanceResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_account_balance
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_account_balance
Risposta (formato JSON)
{
  "GetAccountBalanceResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "BalanceList": [
      {
        "Currency": "USD",
        "Amount": "300.00"
      }
    ]
  }
}
 

Imposta Whois predefinito

Supporto multi-thread
Supporta API Sandbox

Se chiami il comando set default Whois, i seguenti parametri devono essere inclusi:

Imposta il parametro predefinito della richiesta Whois
Spiegazione
registrant_contactLe informazioni del registrante del dominio
admin_contactLe informazioni dell'amministratore del dominio
technical_contactLe informazioni tecniche del dominio
billing_contactLe informazioni di fatturazione del dominio
Tag XML del risultato
Spiegazione
<SetDefaultWhoisResponse></SetDefaultWhoisResponse>Nodo radice del documento XML di risposta
<SetDefaultWhoisHeader></SetDefaultWhoisHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di Set Default Whois

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_whois&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_whois&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Risposta (formato XML)
<SetDefaultWhoisResponse>
   <SetDefaultWhoisHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </SetDefaultWhoisHeader>
</SetDefaultWhoisResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_whois&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_whois&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Risposta (formato JSON)
{
   "SetDefaultWhoisResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Imposta Name Server predefiniti

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando per impostare i name server predefiniti, occorre includere i seguenti parametri:

Parametro della richiesta di impostazione dei Name Server predefiniti
Spiegazione
ns0 - ns12I name server che vuoi impostare
Tag XML del risultato
Spiegazione
<SetDefaultNsResponse></SetDefaultNsResponse>Tag della risposta di impostazione dei name server predefiniti, è il nodo radice del documento XML di risposta
<SetDefaultNsHeader></SetDefaultNsHeader>Tag dell'intestazione di impostazione dei server dei nomi predefiniti
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<SetDefaultNsContent></SetDefaultNsContent>Tag del contenuto di impostazione dei name server predefiniti, viene usato solo quando lo stato è "success"
<Servers></Servers>Le informazioni dei server che hai impostato
<Server></Server>Ogni server
<ServerName></ServerName>Nome del server
<ServerId></ServerId>ID server

Esempio di Set Default Ns

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetDefaultNsResponse>
  <SetDefaultNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultNsHeader>
  <SetDefaultNsContent>
    <Servers>
      <Server>
        <ServerName>ns1.hosts.com</ServerName>
        <ServerId>0</ServerId>
      </Server>
      <Server>
        <ServerName>ns2.hosts.com</ServerName>
        <ServerId>1</ServerId>
      </Server>
    </Servers>
  </SetDefaultNsContent>
</SetDefaultNsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
Risposta (formato JSON)
{
  "SetDefaultNsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "SetDefaultNsContent": {
      "Servers": [
        {
          "ServerName": "ns1.hosts.com",
          "ServerId": "0"
        },
        {
          "ServerName": "ns2.hosts.com",
          "ServerId": "1"
        }
      ]
    }
  }
}
 

Imposta il comando di parcheggio predefinito

Supporto multi-thread
Supporta API Sandbox

Se si richiama il comando di impostazione del parcheggio predefinito, è necessario includere i seguenti parametri:

Imposta il parametro predefinito della richiesta di parking
Spiegazione
with_ads (optional)Se non vuoi pubblicità di terze parti, puoi usare questo parametro con "no", il valore predefinito è "yes"
Tag XML del risultato
Spiegazione
<SetDefaultParkingResponse></SetDefaultParkingResponse>Nodo radice del documento XML di risposta
<SetDefaultParkingHeader></SetDefaultParkingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione del parcheggio predefinito

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_parking&folder_id=0&with_ads=no
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_parking&folder_id=0&with_ads=no
Risposta (formato XML)
<SetDefaultParkingResponse>
   <SetDefaultParkingHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </SetDefaultParkingHeader>
</SetDefaultParkingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_parking&folder_id=0&with_ads=no
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_parking&folder_id=0&with_ads=no
Risposta (formato JSON)
{
   "SetDefaultParkingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Imposta Inoltro Predefinito

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando di impostazione dell'inoltro predefinito, è necessario includere i seguenti parametri:

Parametro di richiesta per impostare l'inoltro predefinito
Spiegazione
forward_urlL'URL verso cui vuoi reindirizzare il tuo dominio. Tieni presente che il parametro deve essere codificato in modo che la chiamata API venga interpretata correttamente.
is_temp (optional)Stato di inoltro del tuo dominio che desideri, il valore predefinito è "temporary", se vuoi inoltrare permanentemente, usa questo parametro con "no"
Tag XML del risultato
Spiegazione
<SetDefaultForwardingResponse></SetDefaultForwardingResponse>Nodo radice del documento XML di risposta
<SetDefaultForwardingHeader></SetDefaultForwardingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione dell'inoltro predefinito

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
Risposta (formato XML)
<SetDefaultForwardingResponse>
  <SetDefaultForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultForwardingHeader>
</SetDefaultForwardingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
Risposta (formato JSON)
{
   "SetDefaultForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Imposta Stealth predefinito

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set default stealth, è necessario includere i seguenti parametri:

Imposta il parametro predefinito della richiesta stealth
Spiegazione
stealth_urlL'URL verso cui vuoi reindirizzare il tuo dominio. Tieni presente che il parametro deve essere codificato in modo che la chiamata API venga interpretata correttamente.
stealth_title (optional)Il titolo della pagina
Tag XML del risultato
Spiegazione
<SetDefaultStealthResponse></SetDefaultStealthResponse>Nodo radice del documento XML di risposta
<SetDefaultStealthHeader></SetDefaultStealthHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione Stealth predefinito

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Risposta (formato XML)
<SetDefaultStealthResponse>
  <SetDefaultStealthHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultStealthHeader>
</SetDefaultStealthResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Risposta (formato JSON)
{
   "SetDefaultStealthResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando per impostare l'hosting predefinito

Supporto multi-thread
Supporta API Sandbox

Se chiami il comando set default hosting, i seguenti parametri devono essere inclusi:

Imposta parametro richiesta hosting predefinito
Spiegazione
hosting_typeTipo di hosting predefinito che vuoi, puoi selezionare in "advanced" e "basic"
Tag XML del risultato
Spiegazione
<SetDefaultHostingResponse></SetDefaultHostingResponse>Nodo radice del documento XML di risposta
<SetDefaultHostingHeader></SetDefaultHostingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione hosting predefinito

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_hosting&hosting_type=advanced
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_hosting&hosting_type=advanced
Risposta (formato XML)
<SetDefaultHostingResponse>
  <SetDefaultHostingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultHostingHeader>
</SetDefaultHostingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_hosting&hosting_type=advanced
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_hosting&hosting_type=advanced
Risposta (formato JSON)
{
   "SetDefaultHostingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando per impostare DNS predefinito

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set default DNS, i seguenti parametri dovrebbero essere inclusi:

( Questo comando è obsoleto e non consigliato, usa invece il comando Imposta DNS2 predefinito )

Imposta parametro richiesta DNS predefinito
Spiegazione
main_record_typeTipo di record principale
main_recordSpecifica un record DNS per il tuo dominio
main_txt (optional)Specifica un record TXT per il tuo dominio. Se il tuo main_record_type è aaaa e hai specificato un main_record2, puoi impostare fino a 3 main_txts, altrimenti puoi impostare fino a 4 main_txts.
main_record2Record principale 2, usato solo quando "main_record_type" è "aaaa". Il suo valore deve essere in formato ipv4.
subdomain0 - subdomain99 (optional)Record dei sottodomini
sub_record_type0 - sub_record_type99 (optional)Tipo di record sottodominio
sub_record0 - sub_record99 (optional)Indirizzo IP o host di destinazione
mx_host0 - mx_host2 (optional)Specifica il mail host per il tuo dominio, distance0 ha la priorità più alta.
mx_distance0 - mx_distance2 (optional)Distance0 ha la priorità più alta
ttl (optional)Tempo di vita
Tag XML del risultato
Spiegazione
<SetDefaultDnsResponse></SetDefaultDnsResponse>Nodo radice del documento XML di risposta
<SetDefaultDnsHeader></SetDefaultDnsHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione DNS predefinito

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Risposta (formato XML)
<SetDefaultDnsResponse>
  <SetDefaultDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultDnsHeader>
</SetDefaultDnsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Risposta (formato JSON)
{
   "SetDefaultDnsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Imposta DNS2 predefinito

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set default DNS, i seguenti parametri dovrebbero essere inclusi:

Parametro di richiesta per impostare DNS2 predefinito
Spiegazione
main_record_type0 - main_record_type19Tipo di record principale
main_record0 - main_record19Specifica il record DNS per il tuo dominio
main_recordx0 - main_recordx19Distanza Mx, tipo di inoltro, titolo inoltro stealth o alias email, necessari quando main_record è "a", "aaaa", "cname", "forward", "txt", "mx", "stealth", "email"
subdomain0 - subdomain99 (optional)Record dei sottodomini
sub_record_type0 - sub_record_type99 (optional)Tipo di record sottodominio
sub_record0 - sub_record99 (optional)Indirizzo IP del sottodominio o host di destinazione
sub_recordx0 - subdo_recordx99Distanza MX, tipo di inoltro, titolo inoltro stealth o alias email, necessario quando sub_record_type è "a", "aaaa", "cname", "forward", "txt", "srv", "mx", "stealth", "email"
ttl (optional)Tempo di vita
Tag XML del risultato
Spiegazione
<SetDefaultDnsResponse></SetDefaultDnsResponse>Nodo radice del documento XML di risposta
<SetDefaultDnsHeader></SetDefaultDnsHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione DNS2 predefinito

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Risposta (formato XML)
<SetDefaultDnsResponse>
  <SetDefaultDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultDnsHeader>
</SetDefaultDnsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Risposta (formato JSON)
{
   "SetDefaultDnsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando per impostare l'inoltro email predefinito

Supporto multi-thread
Supporta API Sandbox

Se chiami il comando set default email forward, i seguenti parametri dovrebbero essere inclusi:

Parametro della richiesta di impostazione dell'inoltro email predefinito
Spiegazione
forward_typeTipo di inoltro, può essere "donot": Non inoltrare email, "mx": Consegna email a un altro host di posta (record MX), "forward": Consegna email a un altro host di posta
username0 - username9Nome utente, usato solo quando "forward_type" è "forward"
exist_email0 - exist_email9Indirizzo email esistente, utilizzato solo quando "forward_type" è "forward"
mx_host0 - mx_host2Host della posta, usato solo quando "forward_type" è "mx"
mx_distance0 - mx_distance2Distance0 è la priorità più alta, utilizzato solo quando "forward_type" è "mx"
Tag XML del risultato
Spiegazione
<SetDefaultEmailForwardingResponse></SetDefaultEmailForwardingResponse>Nodo radice del documento XML di risposta
<SetDefaultEmailForwardingHeader></SetDefaultEmailForwardingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione dell'inoltro email predefinito

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_email_forward&forward_type=forward&username0=test&[email protected]
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_email_forward&forward_type=forward&username0=test&[email protected]
Risposta (formato XML)
<SetDefaultEmailForwardingResponse>
  <SetDefaultEmailForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultEmailForwardingHeader>
</SetDefaultEmailForwardingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_email_forward&forward_type=forward&username0=test&[email protected]
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_email_forward&forward_type=forward&username0=test&[email protected]
Risposta (formato JSON)
{
   "SetDefaultEmailForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Imposta Cancella Impostazione Predefinita

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set clear default setting, è necessario includere i seguenti parametri:

Imposta parametro richiesta cancellazione impostazione predefinita
Spiegazione
serviceIl servizio che vuoi cancellare, può essere "forward", "stealth", "email_forwarding", "dns" e "nameservers"
Tag XML del risultato
Spiegazione
<SetClearDefaultSettingResponse></SetClearDefaultSettingResponse>Nodo radice del documento XML di risposta
<SetClearDefaultSettingHeader></SetClearDefaultSettingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione predefinita Imposta Cancella

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_clear_default_setting&service=nameservers
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_clear_default_setting&service=nameservers
Risposta (formato XML)
<SetClearDefaultSettingResponse>
  <SetClearDefaultSettingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetClearDefaultSettingHeader>
</SetClearDefaultSettingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_clear_default_setting&service=nameservers
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_clear_default_setting&service=nameservers
Risposta (formato JSON)
{
   "SetClearDefaultSettingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Imposta Opzione Rinnovo Predefinita

Supporto multi-thread
Supporta API Sandbox

Se viene chiamato il comando set default renew option, è necessario includere i seguenti parametri:

Parametro di richiesta per impostare l'opzione di rinnovo predefinita
Spiegazione
renew_optionPuò essere "donot", "auto", "reset"
Tag XML del risultato
Spiegazione
<SetDefaultRenewOptionResponse></SetDefaultRenewOptionResponse>Nodo radice del documento XML di risposta
<SetDefaultRenewOptionHeader></SetDefaultRenewOptionHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione dell'opzione di rinnovo predefinita

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_renew_option&renew_option=auto
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_renew_option&renew_option=auto
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetDefaultRenewOptionResponse>
  <SetDefaultRenewOptionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultRenewOptionHeader>
</SetDefaultRenewOptionResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_renew_option&renew_option=auto
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_renew_option&renew_option=auto
Risposta (formato JSON)
{
  "SetDefaultRenewOptionResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

Comando Crea cartella

Supporto multi-thread
Supporta API Sandbox

Se chiami il comando create folder, i seguenti parametri devono essere inclusi:

Parametro della richiesta di creazione cartella
Spiegazione
folder_nameNome della cartella che vuoi creare
Tag XML del risultato
Spiegazione
<FolderCreateResponse></FolderCreateResponse>Nodo radice del documento XML di risposta
<FolderCreateHeader></FolderCreateHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<FolderCreateContent></FolderCreateContent>Contenuto della risposta
<FolderName></FolderName>nome della cartella
<FolderId></FolderId>ID della nuova cartella

Esempio di creazione cartella

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=create_folder&folder_name=new
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=create_folder&folder_name=new
Risposta (formato XML)
<FolderCreateResponse>
  <FolderCreateHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </FolderCreateHeader>
  <FolderCreateContent>
    <FolderName>new</FolderName>
    <FolderId>1</FolderId>
  </FolderCreateContent>
</FolderCreateResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=create_folder&folder_name=new
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=create_folder&folder_name=new
Risposta (formato JSON)
{
   "FolderCreateResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "FolderCreateContent":{
         "FolderName":"new",
         "FolderId":"1"
      }
   }
}
 

Comando Elimina cartella

Supporto multi-thread
Supporta API Sandbox

Se chiami il comando set Whois, vanno inclusi i seguenti parametri:

Parametro della richiesta di eliminazione cartella
Spiegazione
folder_idL'ID delle cartelle che vuoi eliminare, assicurati che siano separate da virgole
Tag XML del risultato
Spiegazione
<DeleteFolderResponse></DeleteFolderResponse>Nodo radice del documento XML di risposta
<DeleteFolderHeader></DeleteFolderHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di eliminazione cartella

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_folder&folder_id=0,1
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete_folder&folder_id=0,1
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteFolderResponse>
  <DeleteFolderHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteFolderHeader>
</DeleteFolderResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_folder&folder_id=0,1
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete_folder&folder_id=0,1
Risposta (formato JSON)
{
  "DeleteFolderResponse": {
    "SuccessCode": 0,
    "Status": "success"
  }
}
 

Comando Imposta Whois della cartella

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set folder Whois, i seguenti parametri dovrebbero essere inclusi:

Parametro Imposta richiesta Whois cartella
Spiegazione
folder_idL'ID della cartella che vuoi impostare
registrant_contactLe informazioni del registrante del dominio
admin_contactLe informazioni dell'amministratore del dominio
technical_contactLe informazioni tecniche del dominio
billing_contactLe informazioni di fatturazione del dominio
enable (optional)Se vuoi applicare questa impostazione Whois ai domini futuri che sposti in questa cartella, puoi usare questo parametro con "yes"
sync (optional)Se vuoi sincronizzare questa impostazione Whois di tutti i domini in questa cartella, puoi usare questo parametro con "yes"
Tag XML del risultato
Spiegazione
<SetFolderWhoisResponse></SetFolderWhoisResponse>Nodo radice del documento XML di risposta
<SetFolderWhoisHeader></SetFolderWhoisHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di Whois per l'impostazione della cartella

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_whois&folder_id=0&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_whois&folder_id=0&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Risposta (formato XML)
<SetFolderWhoisResponse>
  <SetFolderWhoisHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderWhoisHeader>
</SetFolderWhoisResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_whois&folder_id=0&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_whois&folder_id=0&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Risposta (formato JSON)
{
   "SetFolderWhoisResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando imposta name server della cartella

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set folder name servers, è necessario includere i seguenti parametri:

Parametro di richiesta per impostare i server dei nomi della cartella
Spiegazione
fold_idL'ID della cartella che vuoi impostare, è possibile impostare solo 1 cartella per richiesta
ns0 - ns12I name server da impostare per il tuo dominio, puoi specificare fino a 13 name server, ma devono essere già presenti nel tuo account
enable (optional)Se vuoi applicare questa impostazione dei name server ai domini futuri che sposti in questa cartella, puoi usare questo parametro con "yes"
sync (optional)Se vuoi sincronizzare le impostazioni dei name server di tutti i domini in questa cartella, puoi usare questo parametro con "yes"
Tag XML del risultato
Spiegazione
<SetFolderNsResponse></SetFolderNsResponse>Tag della risposta del server per impostare il nome della cartella; è il nodo radice del documento XML di risposta
<SetFolderNsHeader></SetFolderNsHeader>Tag dell'header di risposta del name server della cartella impostata
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<SetFolderNsContent></SetFolderNsContent>Tag del contenuto della risposta del server dei nomi della cartella impostata, è utilizzato solo quando lo stato è "success"
<Servers></Servers>Le informazioni dei server che hai impostato
<Server></Server>Ogni server
<ServerName></ServerName>Nome del server
<ServerId></ServerId>ID server

Esempio di impostazione cartella Ns

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetFolderNsResponse>
  <SetFolderNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderNsHeader>
  <SetFolderNsContent>
    <Servers>
      <Server>
        <ServerName>ns1.hosts.com</ServerName>
        <ServerId>0</ServerId>
      </Server>
      <Server>
        <ServerName>ns2.hosts.com</ServerName>
        <ServerId>1</ServerId>
      </Server>
    </Servers>
  </SetFolderNsContent>
</SetFolderNsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
Risposta (formato JSON)
{
  "SetFolderNsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "SetFolderNsContent": {
      "Servers": [
        {
          "ServerName": "ns1.hosts.com",
          "ServerId": "0"
        },
        {
          "ServerName": "ns2.hosts.com",
          "ServerId": "1"
        }
      ]
    }
  }
}
 

Comando Imposta parcheggio cartella

Supporto multi-thread
Supporta API Sandbox

Se si richiama il comando set folder parking, i seguenti parametri devono essere inclusi:

Imposta parametro richiesta parcheggio cartella
Spiegazione
folder_idL'ID della cartella che vuoi impostare, è possibile impostare solo 1 cartella per richiesta
with_ads (optional)Se non vuoi pubblicità di terze parti, puoi usare questo parametro con "no", il valore predefinito è "yes"
enable (optional)Se vuoi applicare questa impostazione di parcheggio ai domini futuri che sposti in questa cartella, puoi usare questo parametro con "yes"
sync (optional)Se vuoi sincronizzare l'impostazione di parking di tutti i domini in questa cartella, puoi usare questo parametro con "yes"
Tag XML del risultato
Spiegazione
<SetFolderParkingResponse></SetFolderParkingResponse>Nodo radice del documento XML di risposta
<SetFolderParkingHeader></SetFolderParkingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione del parcheggio cartella

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_parking&folder_id=0&with_ads=no
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_parking&folder_id=0&with_ads=no
Risposta (formato XML)
<SetFolderParkingResponse>
  <SetFolderParkingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderParkingHeader>
</SetFolderParkingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_parking&folder_id=0&with_ads=no
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_parking&folder_id=0&with_ads=no
Risposta (formato JSON)
{
   "SetFolderParkingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Imposta inoltro cartella

Supporto multi-thread
Supporta API Sandbox

Se chiami il comando set folder forwarding, i seguenti parametri devono essere inclusi:

Imposta parametro richiesta di inoltro cartella
Spiegazione
folder_idL'ID della cartella che vuoi impostare
forward_urlL'URL verso cui vuoi reindirizzare il tuo dominio. Tieni presente che il parametro deve essere codificato in modo che la chiamata API venga interpretata correttamente.
is_temp (optional)Stato di inoltro del tuo dominio che desideri, il valore predefinito è "temporary", se vuoi inoltrare permanentemente, usa questo parametro con "no"
enable (optional)Se vuoi applicare questa impostazione di inoltro ai domini futuri che sposti in questa cartella, puoi usare questo parametro con "yes"
sync (optional)Se vuoi sincronizzare l'impostazione di inoltro di tutti i domini in questa cartella, puoi usare questo parametro con "yes"
Tag XML del risultato
Spiegazione
<SetFolderForwardingResponse></SetFolderForwardingResponse>Nodo radice del documento XML di risposta
<SetFolderForwardingHeader></SetFolderForwardingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione dell'inoltro cartella

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
Risposta (formato XML)
<SetFolderForwardingResponse>
  <SetFolderForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderForwardingHeader>
</SetFolderForwardingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
Risposta (formato JSON)
{
   "SetFolderForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Imposta cartella Stealth

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set folder stealth, è necessario includere i seguenti parametri:

Parametro della richiesta Set Folder Stealth
Spiegazione
folder_idL'ID della cartella che vuoi impostare
stealth_urlL'URL verso cui vuoi reindirizzare il tuo dominio. Tieni presente che il parametro deve essere codificato in modo che la chiamata API venga interpretata correttamente.
stealth_title (optional)Il titolo della pagina
enable (optional)Se vuoi applicare questa impostazione stealth ai domini futuri che sposti in questa cartella, puoi usare questo parametro con "yes"
sync (optional)Se vuoi sincronizzare l'impostazione stealth di tutti i domini in questa cartella, puoi usare questo parametro con "yes"
Tag XML del risultato
Spiegazione
<SetFolderStealthResponse></SetFolderStealthResponse>Nodo radice del documento XML di risposta
<SetFolderStealthHeader></SetFolderStealthHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di Set Folder Stealth

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
Risposta (formato XML)
<SetFolderStealthResponse>
  <SetFolderStealthHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderStealthHeader>
</SetFolderStealthResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
Risposta (formato JSON)
{
   "SetFolderStealthResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Imposta hosting cartella

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set folder hosting, è necessario includere i seguenti parametri:

Imposta parametro della richiesta di hosting della cartella
Spiegazione
folder_idL'ID della cartella che vuoi impostare
hosting_typeTipo di hosting desiderato, puoi scegliere tra "advanced" e "basic"
enable (optional)Se vuoi applicare questa impostazione di hosting ai domini futuri che sposti in questa cartella, puoi usare questo parametro con "yes"
even (optional)Se vuoi sincronizzare l'impostazione di hosting di tutti i domini in questa cartella, puoi usare questo parametro con "yes"
Tag XML del risultato
Spiegazione
<SetFolderHostingResponse></SetFolderHostingResponse>Nodo radice del documento XML di risposta
<SetFolderHostingHeader></SetFolderHostingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di configurazione hosting cartella

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
Risposta (formato XML)
<SetFolderHostingResponse>
  <SetFolderHostingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderHostingHeader>
</SetFolderHostingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
Risposta (formato JSON)
{
   "SetFolderHostingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Imposta il comando DNS della cartella

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set folder DNS, è necessario includere i seguenti parametri:

( Questo comando è obsoleto e non consigliato, si prega di utilizzare invece il comando Set Folder DNS2 )

Parametro della richiesta di impostazione DNS della cartella
Spiegazione
folder_idL'ID della cartella che vuoi impostare
main_record_typeTipo di record principale
main_recordSpecifica un record DNS per il tuo dominio
main_recordSpecifica un record DNS per il tuo dominio
with_ads (optional)Specifica un record TXT per il tuo dominio. Se il tuo main_record_type è aaaa e hai specificato un main_record2, puoi impostare fino a 3 main_txts, altrimenti puoi impostare fino a 4 main_txts.
main_record2Record principale 2, usato solo quando "main_record_type" è "aaaa". Il suo valore deve essere in formato ipv4.
subdomain0 - subdomain99 (optional)Record del sottodominio (opzionale)
sub_record_type0 - sub_record_type99 (optional)Tipo di record sottodominio
sub_record0 - sub_record99 (optional)Indirizzo IP o host di destinazione
mx_host0 - mx_host2 (optional)Specifica il mail host per il tuo dominio, distance0 ha la priorità più alta.
mx_distance0 - mx_distance2 (optional)Distance0 ha la priorità più alta
ttl (optional)Tempo di vita
enable (optional)Se vuoi applicare questa impostazione DNS ai domini futuri che sposterai in questa cartella, puoi usare questo parametro con "yes"
sync (optional)Se vuoi sincronizzare questa impostazione del server DNS di tutti i domini in questa cartella, puoi usare questo parametro con "yes"
Tag XML del risultato
Spiegazione
<SetFolderDnsResponse></SetFolderDnsResponse>Nodo radice del documento XML di risposta
<SetFolderDnsHeader></SetFolderDnsHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di configurazione DNS della cartella

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Risposta (formato XML)
<SetFolderDnsResponse>
  <SetFolderDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderDnsHeader>
</SetFolderDnsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Risposta (formato JSON)
{
   "SetFolderDnsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Imposta comando cartella DNS2

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set folder DNS2, è necessario includere i seguenti parametri:

Parametro della richiesta Set Folder DNS2
Spiegazione
folder_idL'ID della cartella che vuoi impostare
main_record_type0 - main_record_type19Tipo di record principale, dovrebbe essere "a", "aaaa", "cname", "forward", "txt", "mx", "stealth", "email"
main_record0 - main_record19Specifica il record DNS per il tuo dominio
main_recordx0 - main_recordx19Distanza MX, tipo di inoltro, titolo di inoltro stealth o alias email, necessario quando main_record_type è "forward","mx","stealth","email"
subdomain0 - subdomain99 (optional)Record del sottodominio (opzionale)
sub_record_type0 - sub_record_type99 (optional)Tipo di record del sottodominio, dovrebbe essere "a", "aaaa", "cname", "forward", "txt", "srv", "mx", "stealth", "email"
sub_record0 - sub_record99 (optional)Indirizzo IP o host di destinazione
sub_recordx0 - sub_recordx99 (optional)Distanza Mx, tipo di inoltro, titolo inoltro stealth o alias email, necessari quando sub_record_type è "forward","mx","stealth","email"
ttl (optional)Tempo di vita
enable (optional)Se vuoi applicare questa impostazione DNS ai domini futuri che sposterai in questa cartella, puoi usare questo parametro con "yes"
sync (optional)Se vuoi sincronizzare questa impostazione del server DNS di tutti i domini in questa cartella, puoi usare questo parametro con "yes"
Tag XML del risultato
Spiegazione
<SetFolderDnsResponse></SetFolderDnsResponse>Nodo radice del documento XML di risposta
<SetFolderDnsHeader></SetFolderDnsHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Imposta esempio cartella Dns2

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetFolderDnsResponse>
  <SetFolderDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderDnsHeader>
</SetFolderDnsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Risposta (formato JSON)
{
  "SetFolderDnsResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

Comando di inoltro email per l'impostazione della cartella

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set folder email forward, è necessario includere i seguenti parametri:

Parametro della richiesta di impostazione della cartella di inoltro email
Spiegazione
domainIl nome di dominio che vuoi impostare, puoi impostare 100 domini per richiesta, assicurati che siano separati da virgole
folder_idID della cartella che vuoi impostare
forward_typeTipo di inoltro, può essere "donot": Non inoltrare email, "mx": Consegna email a un altro host di posta (record MX), "forward": Consegna email a un altro host di posta
username0 - username9Nome utente, usato solo quando "forward_type" è "forward"
exist_email0 - exist_email9Indirizzo email esistente, utilizzato solo quando "forward_type" è "forward"
mx_host0 - mx_host2Host della posta, usato solo quando "forward_type" è "mx"
mx_distance0 - mx_distance2Distance0 è la priorità più alta, utilizzato solo quando "forward_type" è "mx"
enable (optional)Se vuoi applicare questa impostazione ai domini futuri che sposti in questa cartella, puoi usare questo parametro con "yes"
sync (optional)Se vuoi sincronizzare questa impostazione di tutti i domini in questa cartella, puoi usare questo parametro con "yes"
Tag XML del risultato
Spiegazione
<SetFolderEmailForwardingResponse></SetFolderEmailForwardingResponse>Nodo radice del documento XML di risposta
<SetFolderEmailForwardingHeader></SetFolderEmailForwardingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di Set Folder Email Forward

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&[email protected]
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&[email protected]
Risposta (formato XML)
<SetFolderEmailForwardingResponse>
  <SetFolderEmailForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderEmailForwardingHeader>
</SetFolderEmailForwardingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&[email protected]
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&[email protected]
Risposta (formato JSON)
{
   "SetFolderEmailForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Imposta impostazione Svuota cartella

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set clear folder setting, è necessario includere i seguenti parametri:

Imposta parametro di richiesta per l'impostazione di cancellazione cartella
Spiegazione
folder_idL'ID della cartella che vuoi impostare
serviceIl servizio che vuoi cancellare, può essere "forward", "stealth", "email_forwarding", "dns" e "nameservers"
Tag XML del risultato
Spiegazione
<SetClearFolderSettingResponse></SetClearFolderSettingResponse>Nodo radice del documento XML di risposta
<SetClearFolderSettingHeader></SetClearFolderSettingHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di Imposta/Cancella impostazione cartella

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
Risposta (formato XML)
<SetClearFolderSettingResponse>
  <SetClearFolderSettingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetClearFolderSettingHeader>
</SetClearFolderSettingResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
Risposta (formato JSON)
{
   "SetClearFolderSettingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando per impostare il nome della cartella

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando imposta nome cartella, i seguenti parametri devono essere inclusi:

Imposta il parametro della richiesta del nome cartella
Spiegazione
folder_idID della cartella che vuoi impostare
folder_nameNome nuova cartella
Tag XML del risultato
Spiegazione
<SetFolderNameResponse></SetFolderNameResponse>Nodo radice del documento XML di risposta
<SetFolderNameHeader></SetFolderNameHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione nome cartella

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_name&folder_id=0&folder_name=new
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_name&folder_id=0&folder_name=new
Risposta (formato XML)
<SetFolderNameResponse>
  <SetFolderNameHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderNameHeader>
</SetFolderNameResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_name&folder_id=0&folder_name=new
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_name&folder_id=0&folder_name=new
Risposta (formato JSON)
{
   "SetFolderNameResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Set Folder Renew Option

Supporto multi-thread
Supporta API Sandbox

Se si chiama il comando set folder renew option, è necessario includere i seguenti parametri:

Parametro della richiesta Set Folder Renew Option
Spiegazione
folder_idL'ID della cartella che vuoi impostare, è possibile impostare solo 1 cartella per richiesta
renew_optionL'opzione di rinnovo che vuoi impostare per la cartella; può essere "donot", "auto" o "reset"
enable (optional)Se vuoi applicare questa impostazione di rinnovo ai domini futuri che sposti in questa cartella, puoi usare questo parametro con "yes"
sync (optional)Se vuoi sincronizzare l'impostazione di rinnovo di tutti i domini in questa cartella, puoi usare questo parametro con "yes"
Tag XML del risultato
Spiegazione
<Response></Response>Nodo radice del documento XML di risposta
<ResponseHeader></ResponseHeader>Intestazione risposta
<ResponseCode></ResponseCode>Codice di risposta, "0" per successo, "-1" per fallimento
<Error></Error>Informazione di errore, viene usata solo quando il codice di risposta è "-1"

Esempio Imposta Opzione Rinnovo Cartella

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
Risposta (formato XML)
<SetFolderRenewOptionResponse>
  <SetFolderRenewOptionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderRenewOptionHeader>
</SetFolderRenewOptionResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
Risposta (formato JSON)
{
   "SetFolderRenewOptionResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando elenco cartelle

Supporto multi-thread
Supporta API Sandbox

Questo comando è disponibile solo nei formati XML e JSON:

Parametro di richiesta elenco cartelle
Spiegazione
N/ANessun parametro aggiuntivo necessario
<FolderListResponse></FolderListResponse>Nodo radice del documento XML di risposta
<FolderListHeader></FolderListHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<FolderListContent></FolderListContent>Contenuto della risposta
<FolderList></FolderList>Elenco cartelle
<List></List>
<Folder></Folder>
<FolderId></FolderId>ID cartella
<FolderName></FolderName>Nome della cartella
<DefaultWhois></DefaultWhois>Whois predefinito
<DefaultWhoisEnableStatus></DefaultWhoisEnableStatus>Stato di abilitazione Whois predefinito
<DefaultRegistrant></DefaultRegistrant>Registrante predefinito
<ContactId></ContactId>ID del contatto
<DefaultAdmin></DefaultAdmin>Amministratore predefinito
<DefaultTechnical></DefaultTechnical>Informazioni tecniche predefinite
<DefaultBilling></DefaultBilling>Informazioni di fatturazione predefinite
<DefaultNameServerEnableStatus></DefaultNameServerEnableStatus>Stato di abilitazione del server dei nomi predefinito
<NameServerSettings></NameServerSettings>Impostazioni del name server
<Type></Type>Tipo di name server
<WithAds></WithAds>Con pubblicità o no
<DefaultRenewOption></DefaultRenewOption>Opzione di rinnovo predefinita
<DefaultRenewOptionEnableStatus></DefaultRenewOptionEnableStatus>Stato di abilitazione dell'opzione di rinnovo predefinita
<RenewOption></RenewOption>Opzione di rinnovo
<DefaultTransferLock></DefaultTransferLock>Blocco trasferimento predefinito
<DefaultTransferLockEnableStatus></DefaultTransferLockEnableStatus>Stato di abilitazione predefinito del blocco di trasferimento
<LockStatus></LockStatus>Stato di blocco

Esempio di elenco cartelle

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=folder_list
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=folder_list
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<FolderListResponse>
  <FolderListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </FolderListHeader>
  <FolderListContent>
    <FolderList>
      <List>
        <Folder>
          <FolderId>0</FolderId>
          <FolderName>new</FolderName>
          <DefaultWhois>
            <DefaultWhoisEnableStatus>disable</DefaultWhoisEnableStatus>
            <DefaultRegistrant>
              <ContactId>0</ContactId>
            </DefaultRegistrant>
            <DefaultAdmin>
              <ContactId>0</ContactId>
            </DefaultAdmin>
            <DefaultTechnical>
              <ContactId>0</ContactId>
            </DefaultTechnical>
            <DefaultBilling>
              <ContactId>0</ContactId>
            </DefaultBilling>
          </DefaultWhois>
          <DefaultNameServers>
            <DefaultNameServerEnableStatus>disable</DefaultNameServerEnableStatus>
            <NameServerSettings>
              <Type>Dynadot Parking</Type>
              <WithAds>Yes</WithAds>
            </NameServerSettings>
          </DefaultNameServers>
          <DefaultRenewOption>
            <DefaultRenewOptionEnableStatus>disable</DefaultRenewOptionEnableStatus>
            <RenewOption>no renew option</RenewOption>
          </DefaultRenewOption>
          <DefaultTransferLock>
            <DefaultTransferLockEnableStatus>disable</DefaultTransferLockEnableStatus>
            <LockStatus>locked</LockStatus>
          </DefaultTransferLock>
        </Folder>
      </List>
    </FolderList>
  </FolderListContent>
</FolderListResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=folder_list
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=folder_list
Risposta (formato JSON)
{
  "FolderListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "FolderList": [
      {
        "FolderId": "0",
        "FolderName": "new",
        "DefaultWhois": {
          "DefaultWhoisEnableStatus": "disable",
          "DefaultRegistrant": {
            "ContactId": "0"
          },
          "DefaultAdmin": {
            "ContactId": "0"
          },
          "DefaultTechnical": {
            "ContactId": "0"
          },
          "DefaultBilling": {
            "ContactId": "0"
          }
        },
        "DefaultNameServers": {
          "DefaultTransferLockEnableStatus": "disable",
          "NameServerSettings": {
            "Type": "Dynadot Parking",
            "WithAds": "Yes"
          }
        },
        "DefaultRenewOption": {
          "DefaultRenewOptionEnableStatus": "disable",
          "RenewOption": "no renew option"
        },
        "DefaultTransferLock": {
          "DefaultTransferLockEnableStatus": "disable",
          "LockStatus": "locked"
        }
      }
    ]
  }
}
 

Comando Aggiungi richiesta backorder

Supporto multi-thread
Non supporta API Sandbox

Se si chiama il comando add backorder request, occorre includere i seguenti parametri:

Parametro di richiesta per l'aggiunta di backorder
Spiegazione
domainIl dominio (o i domini) che vuoi aggiungere e per cui accetti di pagare se Dynadot lo cattura; si possono aggiungere 100 domini per richiesta, devono essere separati da virgole
Tag XML del risultato
Spiegazione
<AddBackorderRequestResponse></AddBackorderRequestResponse>Nodo radice del documento XML di risposta
<AddBackorderRequestHeader></AddBackorderRequestHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di richiesta di aggiunta backorder

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
Risposta (formato XML)
<AddBackorderRequestResponse>
  <AddBackorderRequestHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </AddBackorderRequestHeader>
</AddBackorderRequestResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
Risposta (formato JSON)
{
   "AddBackorderRequestResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando Elimina richiesta backorder

Supporto multi-thread
Non supporta API Sandbox

Se chiami il comando delete backorder request, dovrebbero essere inclusi i seguenti parametri:

Parametro della richiesta di eliminazione del backorder
Spiegazione
domainIl dominio o i domini che vuoi rimuovere dalla tua lista di richieste di backorder, puoi rimuovere 100 domini per richiesta, devono essere separati da virgole
Tag XML del risultato
Spiegazione
<DeleteBackorderRequestResponse></DeleteBackorderRequestResponse>Nodo radice del documento XML di risposta
<DeleteBackorderRequestHeader></DeleteBackorderRequestHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di richiesta di eliminazione del backorder

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_backorder_request&domain=domaindropp.com
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete_backorder_request&domain=domaindropp.com
Risposta (formato XML)
<DeleteBackorderRequestResponse>
  <DeleteBackorderRequestHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteBackorderRequestHeader>
</DeleteBackorderRequestResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_backorder_request&domain=domaindropp.com
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete_backorder_request&domain=domaindropp.com
Risposta (formato JSON)
{
   "DeleteBackorderRequestResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

Comando elenco richieste di backorder

Supporto multi-thread
Non supporta API Sandbox

Chiamando il comando di lista richieste di backorder verrà restituita una lista di richieste di backorder dell'account specificato. Se si chiama questo comando, i seguenti parametri dovrebbero essere inclusi:

Parametro di richiesta dell'elenco delle richieste di backorder
Spiegazione
start_dateData di inizio del drop dell'asta che vuoi richiedere, yyyy-mm-dd, come 2015-05-05
end_dateData di fine drop dell'asta che vuoi richiedere, yyyy-mm-dd, come 2015-05-05
Tag XML del risultato
Spiegazione
<BackorderRequestListResponse></BackorderRequestListResponse>Nodo radice del documento XML di risposta
<BackorderRequestListHeader></BackorderRequestListHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<BackorderRequestListContent></BackorderRequestListContent>Contenuto della risposta
<BackorderRequestList></BackorderRequestList>Lista richieste di backorder
<BackorderRequest></BackorderRequest>Richiesta di backorder
<Domain></Domain>Dominio nel tuo elenco
<CutoffTime></CutoffTime>Data limite per eliminare una richiesta in tempo Unix (millisecondi dalla mezzanotte UTC del 1° gennaio 1970)
<BackorderRequestStatus></BackorderRequestStatus>Stato nel processo di drop catching

Esempio di elenco richieste di backorder

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<BackorderRequestListResponse>
  <BackorderRequestListHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </BackorderRequestListHeader>
  <BackorderRequestListContent>
    <BackorderRequestList>
      <BackorderRequest>
        <DomainName>testdrop.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
      <BackorderRequest>
        <DomainName>testdrop3.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
      <BackorderRequest>
        <DomainName>testdrop4.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
      <BackorderRequest>
        <DomainName>testdrop5.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
    </BackorderRequestList>
  </BackorderRequestListContent>
</BackorderRequestListResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
Risposta (formato JSON)
{
  "BackorderRequestListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "BackorderRequestList": [
      {
        "DomainName": "testdrop.com",
        "CutoffTime": "1403914140000",
        "BackorderRequestStatus": "Active"
      },
      {
        "DomainName": "testdrop3.com",
        "CutoffTime": "1403914140000",
        "BackorderRequestStatus": "Active"
      },
      {
        "DomainName": "testdrop4.com",
        "CutoffTime": "1403914140000",
        "BackorderRequestStatus": "Active"
      },
      {
        "DomainName": "testdrop5.com",
        "CutoffTime": "1403914140000",
        "BackorderRequestStatus": "Active"
      }
    ]
  }
}
Richiesta (formato CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
Richiesta Sandbox (formato CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
Risposta (formato CSV)
ok,success,Domain,CutoffTime,BackorderRequestStatus,testdrop.com,1403914140000,Active,testdrop3.com,1403914140000,Active,testdrop4.com,1403914140000,Active,testdrop5.com,1403914140000,Active
 

Comando Ottieni Aste Aperte

Supporto multi-thread
Non supporta API Sandbox

Chiamare il comando get open auctions restituirà un elenco di aste in corso. Se si chiama questo comando, dovrebbero essere inclusi i seguenti parametri:

Parametro di richiesta di Get Open Auctions
Spiegazione
currency (optional)La valuta del risultato restituito, dovrebbe essere "usd", "eur" o "cny", la valuta predefinita è Dollari statunitensi
type (optional)Il tipo di asta che vuoi vedere, dovrebbe essere "expired", "user", "backorder", o "registry_expired", "registrar", se vuoi ottenere più di un tipo di asta, puoi usare "," per separare ogni tipo di asta
count_per_pageQuante entità vengono visualizzate per pagina (massimo 1000)
page_index Le entità di quale pagina vuoi visualizzare
has_bids (optional)Quando questo parametro è true, verranno restituite solo le aste che hanno ricevuto offerte. Se è false, restituisce le aste senza offerte. Se non viene passato, restituisce tutte le aste.
Tag XML del risultato
Spiegazione
<GetOpenAuctionsResponse></GetOpenAuctionsResponse>Tag della risposta get open auctions, è il nodo radice del documento XML di risposta
<GetOpenAuctionsHeader></GetOpenAuctionsHeader>Ottieni l'intestazione delle aste aperte
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetOpenAuctionsContent></GetOpenAuctionsContent>Tag of get open auctions content, it's only used when status is "success"
<Auction></Auction>Tag of auction item, it's only used when status is "success"
<AuctionId></AuctionId>ID dell'asta
<Domain></Domain>Nome del dominio dell'asta
<BidPrice></BidPrice>Prezzo attuale dell'offerta dell'asta
<BidPriceCurrency></BidPriceCurrency>Valuta del prezzo di offerta
<Bids></Bids>Numero di offerte dell'asta
<EndTime></EndTime>Ora di fine dell'asta
<EndTimestamp></EndTimestamp>Data di fine dell'asta in tempo Unix (millisecondi dalla mezzanotte UTC del 1 gennaio 1970)
<Revenue></Revenue>Ricavi dell'asta
<RevenueCurrency></RevenueCurrency>Valuta dei ricavi
<Visitors></Visitors>Visitatori del dominio
<Links></Links>Link in entrata del dominio
<Age></Age>Età del dominio

Esempio di ottenimento aste aperte

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_open_auctions&currency=usd&type=expired&count_per_page=20&page_index=1
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_open_auctions&currency=usd&type=expired&count_per_page=20&page_index=1
Risposta (formato XML)
<GetOpenAuctionsResponse>
  <GetOpenAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetOpenAuctionsHeader>
  <GetOpenAuctionsContent>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
            <Revenue>72</Revenue>
            <RevenueCurrency>USD</RevenueCurrency>
            <Visitors>-1</Visitors>
            <Links>-1</Links>
            <Age>1</Age>
    </Auction>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
            <Revenue>72</Revenue>
            <RevenueCurrency>USD</RevenueCurrency>
            <Visitors>-1</Visitors>
            <Links>-1</Links>
            <Age>1</Age>
    </Auction>
    .
    .
    .
  </GetOpenAuctionsContent>
</GetOpenAuctionsResponse>
Richiesta (formato csv)

https://api.dynadot.com/api3.html?key=mykey&command=get_open_auctions¤cy=usd&type=expired&count_per_page=20&page_index=1

Risposta

ok,
success,
AuctionId,Domain,BidPrice,BidPriceCurrency,Bids,EndTime,EndTimestamp,Revenue,RevenueCurrency,Visitors,Links,Age
10001,domain.com,92.99,USD,0,2015/04/28 18:04 UTC,1430244248274,0.64,USD,-1,-1,1
10002,xn--wkccg.com,77.99,USD,0,2015/05/01 06:04 UTC,1430460248338,86,USD,435,-1,1
10003,domain2.com,11.25,USD,0,2015/05/05 06:04 UTC,1430805846946,91,USD,358,-1,1
.
.
.

Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_open_auctions&currency=usd&type=expired&count_per_page=20&page_index=1
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_open_auctions&currency=usd&type=expired&count_per_page=20&page_index=1
Risposta (formato JSON)
{
    "status": "success",
    "auction_list": [
        {
            "auction_id": 11,
            "domain": "domain.com",
            "utf_name": "domain.com",
            "is_idn": false,
            "auction_type": "expired",
            "currency": "USD",
            "current_bid_price": "124.00",
            "bids": 4,
            "bidders": 2,
            "time_left": "1 day, 23 hours",
            "start_time": "2022/03/28 02:20 PST",
            "start_time_stamp": 1648459234033,
            "end_time": "2022/04/04 02:20 PST",
            "end_time_stamp": 1649064034033,
            "visitors": 223,
            "links": "-",
            "age": 0,
            "dyna_appraisal": "-"
        },
        {
            "auction_id": 12,
            "domain": "domain0.com",
            "utf_name": "domain0.com",
            "is_idn": false,
            "auction_type": "expired",
            "currency": "USD",
            "current_bid_price": "44.99",
            "bids": 1,
            "bidders": 1,
            "time_left": "2 days, 23 hours",
            "start_time": "2022/03/29 02:20 PST",
            "start_time_stamp": 1648545634049,
            "end_time": "2022/04/05 02:20 PST",
            "end_time_stamp": 1649150434049,
            "visitors": 245,
            "links": "-",
            "age": 0,
            "dyna_appraisal": "-"
        }
        ...
    ]
}
 

Comando Ottieni dettagli asta

Supporto multi-thread
Non supporta API Sandbox

Chiamando il comando get auction details verranno restituiti i dettagli dell'asta specificata. Questo comando è disponibile solo in formato XML e JSON. Se si chiama questo comando, è necessario includere i seguenti parametri:

Parametro di richiesta per ottenere i dettagli dell'asta
Spiegazione
domainIl nome di dominio dell'asta, IDN(Nome di dominio internazionale) dovrebbe usare punycode, come "xn--wkccg.com". puoi ottenere più di un'asta, ogni dominio deve essere separato da ","
currency (optional)La valuta del risultato restituito, dovrebbe essere "usd", "eur" o "cny", la valuta predefinita è Dollari statunitensi
Tag XML del risultato
Spiegazione
<GetAuctionDetailsResponse></GetAuctionDetailsResponse>Tag della risposta di get auction details, è il nodo radice del documento XML di risposta
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>Intestazione dettagli asta di backorder
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetAuctionDetailsContent></GetAuctionDetailsContent>Tag of get auction details content, it's only used when status is "success"
<AuctionStatusId></AuctionStatusId>ID stato dell'asta : '0' per In corso, '1' per Annullata dall'utente, '2' per Annullata dall'amministratore, '3' per Annullata per rinnovo, '4' per Completata, '5' per Annullata per trasferimento
<AuctionStatus></AuctionStatus>Stato dell'asta
<UserIsHighBid></UserIsHighBid>Se l'utente ha l'offerta più alta
<YourCurrentBid></YourCurrentBid>Il tuo prezzo di offerta attuale per l'asta specificata. Se non hai fatto un'offerta, sarà '-1'
<YourProxyBid></YourProxyBid>Il tuo offerta proxy per l'asta specificata. Se non hai fatto un'offerta, sarà '-1'
<AuctionId></AuctionId>ID dell'asta
<Domain></Domain>Nome del dominio dell'asta
<BidPrice></BidPrice>Prezzo attuale dell'offerta dell'asta
<BidPriceCurrency></BidPriceCurrency>Valuta del prezzo di offerta
<Bids></Bids>Numero di offerte dell'asta
<EndTime></EndTime>Ora di fine dell'asta
<EndTimestamp></EndTimestamp>Data di fine dell'asta in tempo Unix (millisecondi dalla mezzanotte UTC del 1 gennaio 1970)
<IsPremium></IsPremium>Indica se è un dominio premium
<RenewalPrice></RenewalPrice>Prezzo di rinnovo

Esempio di recupero dettagli asta

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_auction_details&domain=domain0.com&currency=usd
Richiesta Sandbox (formato XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_auction_details&domain=domain0.com&currency=usd
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetAuctionDetailsResponse>
  <GetAuctionDetailsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetAuctionDetailsHeader>
  <GetAuctionDetailsContent>
    <Auction>
      <AuctionStatusId>0</AuctionStatusId>
      <AuctionStatus>1</AuctionStatus>
      <AuctionId>0</AuctionId>
      <Domain>test.biz</Domain>
      <BidPrice>46.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>0</Bids>
      <EndTime>1970/01/01 00:00 UTC</EndTime>
      <EndTimestamp>0</EndTimestamp>
      <Revenue>1</Revenue>
      <RevenueCurrency>USD</RevenueCurrency>
      <Visitors>-1</Visitors>
      <Links>1</Links>
      <Age>10</Age>
      <isPremium>false</isPremium>
      <RenewalPrice>-0.1</RenewalPrice>
      <UserIsHighBid>false</UserIsHighBid>
      <YourCurrentBid>-1</YourCurrentBid>
      <YourProxyBid>-1</YourProxyBid>
    </Auction>
  </GetAuctionDetailsContent>
</GetAuctionDetailsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_auction_details&domain=domain0.com&currency=usd
Richiesta Sandbox (formato JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_auction_details&domain=domain0.com&currency=usd
Risposta (formato JSON)
{
  "status": "success",
  "size": 1,
  "auction_details": [
    {
      "auction_json": {
        "auction_id": 0,
        "domain": "test.biz",
        "utf_name": "test.biz",
        "is_idn": false,
        "auction_type": "expired",
        "current_bid_price": "46.99",
        "accepted_bid_price": "46.99",
        "currency": "USD",
        "is_high_bidder": false,
        "bids": 0,
        "bidders": 0,
        "auction_status_id": 0,
        "time_left": "1",
        "start_time": "1",
        "start_time_stamp": 0,
        "end_time": "",
        "end_time_stamp": 0,
        "revenue": "1",
        "visitors": -1,
        "links": "1",
        "age": 10,
        "estibot_appraisal": "",
        "dyna_appraisal": "",
        "bidder_name": "",
        "bid_price": "",
        "timestamp": 0,
        "bid_status": "",
        "is_proxy_auto_bid": false,
        "auction_ended": false,
        "customer_bided": false,
        "customer_bid": "1",
        "customer_proxy_bid": "1",
        "is_premium": false,
        "renewal_price": "-0.1"
      },
      "bid_history": []
    }
  ]
}
 

Comando per ottenere le offerte dell'asta

Supporto multi-thread
Non supporta API Sandbox

Chiamando il comando get auction bids otterrai l'elenco delle tue offerte a cui hai partecipato. Se chiami questo comando, i seguenti parametri dovrebbero essere inclusi:

Parametro della richiesta per ottenere le offerte dell'asta
Spiegazione
currency (optional)La valuta della tua offerta, dovrebbe essere "usd", "eur", o "cny", la valuta predefinita è Dollari statunitensi
count_per_pageQuante entità vengono visualizzate per pagina (massimo 50)
page_index Le entità di quale pagina vuoi visualizzare
Tag XML del risultato
Spiegazione
<GetAuctionBidsResponse></GetAuctionBidsResponse>Tag della risposta get auction bids, è il nodo radice del documento XML di risposta
<GetAuctionBidsHeader></GetAuctionBidsHeader>Intestazione di Get auction bids
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetAuctionBidsContent></GetAuctionBidsContent>Tag of get auction bids content, it's only used when status is "success"
<BidList></BidList> Elenco delle offerte
<Bid></Bid> Voce dell'offerta
<BidId></BidId> ID dell'offerta
<AuctionId></AuctionId> ID dell'asta
<AccountId></AccountId>ID dell'account
<Domain></Domain>Nome del dominio dell'asta
<DomainUtf></DomainUtf>Nome utf del dominio dell'asta
<AuctionType></AuctionType>Tipo di asta
<IsIdn></IsIdn>Se questo dominio è un nome di dominio internazionalizzato
<CurrentBid></CurrentBid>Prezzo corrente dell'offerta per l'asta
<YourStatus></YourStatus>Lo stato della tua offerta per l'asta
<ProxyBid></ProxyBid>Il tuo prezzo di offerta proxy per l'asta
<ActiveBidders></ActiveBidders>Il numero di offerenti che partecipano a questa asta
<TimeLeft></TimeLeft>il tempo rimanente per l'asta
<EndTime></EndTime>L'ora di fine dell'asta
<EndTimestamp></EndTimestamp>Il timestamp di fine dell'asta

Esempio: Ottieni offerte all'asta

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_auction_bids&currency=usd&count_per_page=20&page_index=1
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_auction_bids&currency=usd&count_per_page=20&page_index=1
Risposta (formato XML)
<GetAuctionBidsResponse>
    <GetAuctionBidsHeader>
        <SuccessCode>0</SuccessCode>
        <Status>success</Status>
    </GetAuctionBidsHeader>
    <GetAuctionBidsContent>
        <BidList>
            <Bid>
                <BidId>0</BidId>
                <AuctionId>11</AuctionId>
                <AccountId>1</AccountId>
                <Domain>domain.com</Domain>
                <DomainUtf>domain.com</DomainUtf>
                <AuctionType>expired</AuctionType>
                <IsIdn>false</IsIdn>
                <CurrentBid>$124.00</CurrentBid>
                <YourStatus>Out Bid</YourStatus>
                <ProxyBid>$119.00</ProxyBid>
                <ActiveBidders>2</ActiveBidders>
                <TimeLeft>1 day, 6 hours</TimeLeft>
                <EndTime>2022/04/04 02:20:34 PST</EndTime>
                <EndTimestamp>1649064034033</EndTimestamp>
            </Bid>
            <Bid>
                <BidId>9</BidId>
                <AuctionId>12</AuctionId>
                <AccountId>1</AccountId>
                <Domain>domain0.com</Domain>
                <DomainUtf>domain0.com</DomainUtf>
                <AuctionType>expired</AuctionType>
                <IsIdn>false</IsIdn>
                <CurrentBid>$44.99</CurrentBid>
                <YourStatus>High Bidder</YourStatus>
                <ProxyBid>$121.00</ProxyBid>
                <ActiveBidders>1</ActiveBidders>
                <TimeLeft>2 days, 6 hours</TimeLeft>
                <EndTime>2022/04/05 02:20:34 PST</EndTime>
                <EndTimestamp>1649150434049</EndTimestamp>
            </Bid>
        </BidList>
    </GetAuctionBidsContent>
</GetAuctionBidsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_auction_bids&currency=usd&count_per_page=20&page_index=1
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_auction_bids&currency=usd&count_per_page=20&page_index=1
Risposta (formato JSON)
{
    "status": "success",
    "auction_bids": [
        {
            "bid_id": 0,
            "auction_id": 11,
            "account_id": "1",
            "domain": "domain.com",
            "domain_utf": "domain.com",
            "auction_type": "expired",
            "is_idn": false,
            "current_bid": "$44.99",
            "your_status": "High Bidder",
            "proxy_bid": "$119.00",
            "active_bidders": 1,
            "time_left": "1 day, 23 hours",
            "end_time": "2022/04/04 02:20:34 PST",
            "end_time_stamp": 1649064034033
        },
        {
            "bid_id": 2,
            "auction_id": 12,
            "account_id": "1",
            "domain": "domain0.com",
            "domain_utf": "domain0.com",
            "auction_type": "expired",
            "is_idn": false,
            "current_bid": "$44.99",
            "your_status": "High Bidder",
            "proxy_bid": "$119.00",
            "active_bidders": 1,
            "time_left": "2 days, 23 hours",
            "end_time": "2022/04/05 02:20:34 PST",
            "end_time_stamp": 1649150434049
        }
        ...
    ]
}
 

Comando per fare un'offerta all'asta

Supporto multi-thread
Non supporta API Sandbox

Chiamando il comando per fare un'offerta all'asta, verrà effettuata un'offerta per l'asta specificata. Se si chiama questo comando, occorre includere i seguenti parametri:

Parametro di richiesta per piazzare un'offerta all'asta
Spiegazione
domainIl nome di dominio dell'asta, IDN (Nome di Dominio Internazionalizzato) dovrebbe usare punycode, come "xn--wkccg.com"
bid_amountL'importo della tua offerta per l'asta, la valuta predefinita è Dollari statunitensi, puoi anche specificarla tramite il parametro currency qui sotto
currency (optional)La valuta della tua offerta, dovrebbe essere "usd", "eur", o "cny", la valuta predefinita è Dollari statunitensi
Tag XML del risultato
Spiegazione
<PlaceAuctionBidResponse></PlaceAuctionBidResponse>Tag della risposta all'offerta dell'asta, è il nodo radice del documento XML di risposta
<PlaceAuctionBidHeader></PlaceAuctionBidHeader>Intestazione per fare un'offerta all'asta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di dominio

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=place_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=place_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
Risposta (formato XML)
<PlaceAuctionBidResponse>
  <PlaceAuctionBidHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </PlaceAuctionBidHeader>
</PlaceAuctionBidResponse>
Richiesta (formato csv)

https://api.dynadot.com/api3.html?key=mykey&command=place_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd

Risposta

ok,success

Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=place_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=place_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
Risposta (formato JSON)
{
    "status": "success",
    "auction_details": {
        "auction_json": {
            "auction_id": 12,
            "domain": "example.com",
            "utf_name": "example.com",
            "is_idn": false,
            "auction_type": "expired",
            "current_bid_price": "44.99",
            "accepted_bid_price": "45.99",
            "currency": "USD",
            "is_high_bidder": true,
            "bids": 3,
            "bidders": 2,
            "time_left": "2 days, 22 hours",
            "start_time": "2022/03/29 02:20 PST",
            "start_time_stamp": 1648545634049,
            "end_time": "2022/04/05 02:20 PST",
            "end_time_stamp": 1649150434049,
            "revenue": "$26.50",
            "visitors": 245,
            "links": "-",
            "age": 0,
            "dyna_appraisal": "-",
            "auction_ended": false,
            "customer_bided": true,
            "customer_bid": "44.99",
            "customer_proxy_bid": "$121.00"
        },
        "bid_history": [
            {
                "bidder_name": "You",
                "bid_price": "44.99",
                "currency": "USD",
                "timestamp": 1648892255084,
                "bid_status": "High Bidder",
                "is_proxy_auto_bid": false
            }
            ...        ]
    }
}
 

Comando Ottieni aste chiuse

Supporto multi-thread
Non supporta API Sandbox

Chiamare il comando get closed auctions restituirà un elenco delle aste chiuse dell'account specificato. Se si chiama questo comando, è necessario includere i seguenti parametri:

Parametro di richiesta per Get Closed Auctions
Spiegazione
start_dateIl timestamp che indica l'inizio dell'ora di fine dell'asta, yyyy-mm-dd, come 2015-05-05
end_dateIl timestamp che indica la fine del tempo di conclusione dell'asta, yyyy-mm-dd, come 2015-05-05
currency (optional)La valuta della tua offerta, dovrebbe essere "usd", "eur", o "cny", la valuta predefinita è Dollari statunitensi
Tag XML del risultato
Spiegazione
<GetClosedAuctionsResponse></GetClosedAuctionsResponse>Tag della risposta di get closed auctions, è il nodo radice del documento XML di risposta
<GetClosedAuctionsHeader></GetClosedAuctionsHeader>Intestazione per ottenere le aste chiuse
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetClosedAuctionsContent></GetClosedAuctionsContent>Tag of get closed auctions content, it's only used when status is "success"
<Auction></Auction>Tag of auction item, it's only used when status is "success"
<AuctionId></AuctionId>ID dell'asta
<Domain></Domain>Nome del dominio dell'asta
<AuctionStatusId></AuctionStatusId>ID stato dell'asta, '0' per In corso e '1' per Chiusa dall'utente, '2' per Chiusa dall'amministratore, '3' per Chiusa per rinnovo, '4' per Chiusa per timeout, '5' per Chiusa per trasferimento in uscita
<AuctionStatus></AuctionStatus>Stato dell'asta
<BidPrice></BidPrice>Prezzo attuale dell'offerta dell'asta
<BidPriceCurrency></BidPriceCurrency>Valuta del prezzo di offerta
<Bids></Bids>Numero di offerte dell'asta
<AuctionWonStatus></AuctionWonStatus>Se l'utente ha vinto questa asta
<YourHighBid></YourHighBid>La tua offerta più alta per questa asta
<YourProxyBid></YourProxyBid>La tua offerta proxy per questa asta

Esempio di recupero aste chiuse

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetClosedAuctionsResponse>
  <GetClosedAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetClosedAuctionsHeader>
  <GetClosedAuctionsContent>
    <Auction>
      <AuctionId>2</AuctionId>
      <Domain>testdomain1.test</Domain>
      <AuctionStatusId>4</AuctionStatusId>
      <AuctionStatus>Closed by Timeout</AuctionStatus>
      <BidPrice>89.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>89.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
    </Auction>
    <Auction>
      <AuctionId>3</AuctionId>
      <Domain>testdomain2.test</Domain>
      <AuctionStatusId>4</AuctionStatusId>
      <AuctionStatus>Closed by Timeout</AuctionStatus>
      <BidPrice>28.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>28.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
    </Auction>
  </GetClosedAuctionsContent>
</GetClosedAuctionsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
Risposta (formato JSON)
{
  "GetClosedAuctionsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Auctions": [
      {
        "AuctionId": "2",
        "Domain": "testdomain1.test",
        "AuctionStatusId": "4",
        "AuctionStatus": "Closed by Timeout",
        "BidPrice": "89.99",
        "BidPriceCurrency": "USD",
        "Bids": "1",
        "AuctionWonStatus": "won",
        "YourHighBid": "89.99",
        "YourProxyBid": "1000.0"
      },
      {
        "AuctionId": "3",
        "Domain": "testdomain2.test",
        "AuctionStatusId": "4",
        "AuctionStatus": "Closed by Timeout",
        "BidPrice": "28.99",
        "BidPriceCurrency": "USD",
        "Bids": "1",
        "AuctionWonStatus": "won",
        "YourHighBid": "28.99",
        "YourProxyBid": "1000.0"
      }
    ]
  }
}
Richiesta (formato CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
Richiesta Sandbox (formato CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
Risposta (formato CSV)
ok,success,AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid,2,testdomain1.test,4,Closed by Timeout,89.99,USD,1,won,89.99,1000.0,3,testdomain2.test,4,Closed by Timeout,28.99,USD,1,won,28.99,1000.0
 

Comando Ottieni aste backorder aperte

Supporto multi-thread
Non supporta API Sandbox

Chiamare il comando get open backorder auctions restituirà un elenco di aste di backorder in corso. Se si chiama questo comando, è necessario includere i seguenti parametri:

Parametro di richiesta Get Open Backorder Auctions
Spiegazione
currency (optional)La valuta del risultato restituito, dovrebbe essere "usd", "eur" o "cny", la valuta predefinita è Dollari statunitensi
Tag XML del risultato
Spiegazione
<GetOpenBackorderAuctionsResponse></GetOpenBackorderAuctionsResponse>Tag della risposta get open backorder auctions, è il nodo radice del documento XML di risposta
<GetOpenBackorderAuctionsHeader></GetOpenBackorderAuctionsHeader>Ottieni l'intestazione delle aste di backorder aperte
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetOpenBackorderAuctionsContent></GetOpenBackorderAuctionsContent>Tag of get open backorder auctions content, it's only used when status is "success"
<Auction></Auction>Tag of auction item, it's only used when status is "success"
<AuctionId></AuctionId>ID dell'asta
<Domain></Domain>Nome del dominio dell'asta
<BidPrice></BidPrice>Prezzo attuale dell'offerta dell'asta
<BidPriceCurrency></BidPriceCurrency>Valuta del prezzo di offerta
<Bids></Bids>Numero di offerte dell'asta
<EndTime></EndTime>Ora di fine dell'asta
<EndTimestamp></EndTimestamp>Data di fine dell'asta in tempo Unix (millisecondi dalla mezzanotte UTC del 1 gennaio 1970)

Esempio di recupero delle aste di backorder aperte

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_open_backorder_auctions&currency=usd
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_open_backorder_auctions&currency=usd
Risposta (formato XML)
<GetOpenBackorderAuctionsResponse>
  <GetOpenBackorderAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetOpenBackorderAuctionsHeader>
  <GetOpenBackorderAuctionsContent>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
    </Auction>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
    </Auction>
    .
    .
    .
  </GetOpenBackorderAuctionsContent>
</GetOpenBackorderAuctionsResponse>
Richiesta (formato csv)

https://api.dynadot.com/api3.html?key=mykey&command=get_open_backorder_auctions¤cy=usd

Risposta

ok,
success,
AuctionId,Domain,BidPrice,BidPriceCurrency,Bids,EndTime,EndTimestamp
10000,backorder0.com,6.35,USD,0,2017/08/29 17:53 UTC,1504029194453
10001,backorder1.com,1.0,USD,0,2017/08/29 17:53 UTC,1504029194453
10002,backorder2.com,1.0,USD,0,2017/08/29 17:53 UTC,1504029194453
.
.
.

 

Comando per ottenere i dettagli dell'asta di backorder

Supporto multi-thread
Non supporta API Sandbox

Chiamando il comando get backorder auction details verranno restituiti i dettagli dell'asta specificata. Questo comando è disponibile solo in formato XML e JSON. Se si chiama questo comando, è necessario includere i seguenti parametri:

Parametro di richiesta per ottenere i dettagli dell'asta
Spiegazione
domainIl nome di dominio dell'asta di backorder, IDN(International Domain Name) dovrebbe usare punycode, come "xn--wkccg.com"
currency (optional)La valuta del risultato restituito, dovrebbe essere "usd", "eur" o "cny", la valuta predefinita è Dollari statunitensi
Tag XML del risultato
Spiegazione
<GetBackorderAuctionDetailsResponse></GetBackorderAuctionDetailsResponse>Tag della risposta di get auction details, è il nodo radice del documento XML di risposta
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>Intestazione per ottenere i dettagli dell'asta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetAuctionDetailsContent></GetAuctionDetailsContent>Tag of get auction details content, it's only used when status is "success"
<AuctionStatusId></AuctionStatusId>ID stato dell'asta, '0' per In corso e '1' per Chiusa dall'utente, '2' per Chiusa dall'amministratore, '3' per Chiusa per rinnovo, '4' per Chiusa per timeout, '5' per Chiusa per trasferimento in uscita
<AuctionStatus></AuctionStatus>Stato dell'asta
<AuctionId></AuctionId>ID dell'asta
<Domain></Domain>Nome del dominio dell'asta
<BidPrice></BidPrice>Prezzo attuale dell'offerta dell'asta
<BidPriceCurrency></BidPriceCurrency>Valuta del prezzo di offerta
<Bids></Bids>Numero di offerte dell'asta
<EndTime></EndTime>Ora di fine dell'asta
<EndTimestamp></EndTimestamp>Data di fine dell'asta in tempo Unix (millisecondi dalla mezzanotte UTC del 1 gennaio 1970)
<Revenue></Revenue>Ricavi dell'asta
<RevenueCurrency></RevenueCurrency>Valuta dei ricavi
<Visitors></Visitors>Visitatori del dominio
<Links></Links>Link in entrata del dominio
<Age></Age>Età del dominio
<UserIsHighBid></UserIsHighBid>Se l'utente ha l'offerta più alta
<YourCurrentBid></YourCurrentBid>Il tuo prezzo di offerta attuale per l'asta specificata. Se non hai fatto un'offerta, sarà '-1'
<YourProxyBid></YourProxyBid>Il tuo offerta proxy per l'asta specificata. Se non hai fatto un'offerta, sarà '-1'

Esempio di ottenimento dettagli asta backorder

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_backorder_auction_details&domain=example.com&currency=usd
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_backorder_auction_details&domain=example.com&currency=usd
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetBackorderAuctionDetailsResponse>
  <GetBackorderAuctionDetailsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetBackorderAuctionDetailsHeader>
  <GetBackorderAuctionDetailsContent>
    <AuctionStatusId>0</AuctionStatusId>
    <AuctionStatus>In Progress</AuctionStatus>
    <UserIsHighBid>no</UserIsHighBid>
    <YourCurrentBid>-1</YourCurrentBid>
    <YourProxyBid>-1</YourProxyBid>
    <Auction>
      <AuctionId>10001</AuctionId>
      <Domain>example.com</Domain>
      <BidPrice>89.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>0</Bids>
      <EndTime>2015/04/28 18:16 UTC</EndTime>
      <EndTimestamp>1430244969779</EndTimestamp>
    </Auction>
  </GetBackorderAuctionDetailsContent>
</GetBackorderAuctionDetailsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_backorder_auction_details&domain=example.com&currency=usd
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_backorder_auction_details&domain=example.com&currency=usd
Risposta (formato JSON)
{
  "GetBackorderAuctionDetailsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "GetBackorderAuctionDetails": {
      "AuctionStatusId": "0",
      "AuctionStatus": "In Progress",
      "UserIsHighBid": "no",
      "YourCurrentBid": "-1",
      "YourProxyBid": "-1",
      "Auction": {
        "AuctionId": "10001",
        "Domain": "example.com",
        "BidPrice": "89.99",
        "BidPriceCurrency": "USD",
        "Bids": "0",
        "EndTime": "2015/04/28 18:16 UTC",
        "EndTimestamp": "1430244969779"
      }
    }
  }
}
 

Comando per piazzare un'offerta all'asta di backorder

Supporto multi-thread
Non supporta API Sandbox

Chiamando il comando place backorder auction bid, verrà piazzata un'offerta per l'asta di backorder specificata. Se si chiama questo comando, occorre includere i seguenti parametri:

Parametro richiesta offerta asta backorder
Spiegazione
domainIl nome di dominio dell'asta, IDN (Nome di Dominio Internazionalizzato) dovrebbe usare punycode, come "xn--wkccg.com"
bid_amountL'importo della tua offerta per l'asta, la valuta predefinita è Dollari statunitensi, puoi anche specificarla tramite il parametro currency qui sotto
currency (optional)La valuta della tua offerta, dovrebbe essere "usd", "eur", o "cny", la valuta predefinita è Dollari statunitensi
Tag XML del risultato
Spiegazione
<PlaceBakcorderAuctionBidResponse></PlaceBakcorderAuctionBidResponse>Tag della risposta all'offerta dell'asta, è il nodo radice del documento XML di risposta
<PlaceBackorderAuctionBidHeader></PlaceBackorderAuctionBidHeader>Intestazione per fare un'offerta all'asta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di offerta per asta di backorder

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
Risposta (formato XML)
<PlaceBakcorderAuctionBidResponse>
 <PlaceBackorderAuctionBidHeader>
   <SuccessCode>0</SuccessCode>
   <Status>success</Status>
 </PlaceBackorderAuctionBidHeader>
</PlaceBakcorderAuctionBidResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
Risposta (formato JSON)
{
   "PlaceBakcorderAuctionBidResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
Richiesta (formato CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
Richiesta Sandbox (formato CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
Risposta (formato CSV)
ok,success
 

Comando per ottenere le aste di backorder chiuse

Supporto multi-thread
Non supporta API Sandbox

Chiamare il comando get closed backorder auctions restituirà un elenco delle aste di backorder chiuse dell'account specificato. Se si chiama questo comando, devono essere inclusi i seguenti parametri:

Parametro di richiesta di Get Closed Backorder Auctions
Spiegazione
start_dateData di inizio dell'asta, aaaa-mm-gg, come 2015-05-05
end_dateData di fine dell'asta, aaaa-mm-gg, come 2015-05-05
currency (optional)La valuta della tua offerta, dovrebbe essere "usd", "eur", o "cny", la valuta predefinita è Dollari statunitensi
Tag XML del risultato
Spiegazione
<GetClosedBackorderAuctionsResponse></GetClosedBackorderAuctionsResponse>Tag della risposta di get closed auctions, è il nodo radice del documento XML di risposta
<GetClosedBackorderAuctionsHeader></GetClosedBackorderAuctionsHeader>Intestazione per ottenere le aste chiuse
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetClosedBackorderAuctionsContent></GetClosedBackorderAuctionsContent>Tag of get closed auctions content, it's only used when status is "success"
<Auction></Auction>Tag of auction item, it's only used when status is "success"
<YourHighBid></YourHighBid>La tua offerta più alta per questa asta
<YourProxyBid></YourProxyBid>La tua offerta proxy per questa asta
<AuctionId></AuctionId>ID dell'asta
<Domain></Domain>Nome del dominio dell'asta
<AuctionStatusId></AuctionStatusId>ID stato dell'asta, '0' per In corso e '1' per Chiusa dall'utente, '2' per Chiusa dall'amministratore, '3' per Chiusa per rinnovo, '4' per Chiusa per timeout, '5' per Chiusa per trasferimento in uscita
<AuctionStatus></AuctionStatus>Stato dell'asta
<BidPrice></BidPrice>Prezzo attuale dell'offerta dell'asta
<BidPriceCurrency></BidPriceCurrency>Valuta del prezzo di offerta
<Bids></Bids>Numero di offerte dell'asta

Esempio di recupero delle aste di backorder chiuse

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetClosedBackorderAuctionsResponse>
  <GetClosedBackorderAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetClosedBackorderAuctionsHeader>
  <GetClosedBackorderAuctionsContent>
    <Auction>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>89.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
      <AuctionId>2</AuctionId>
      <Domain>testdomain1.test</Domain>
      <BidPrice>89.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
      <EndTime>2022/04/04 02:20:34 PST</EndTime>
      <EndTimestamp>1649064034033</EndTimestamp>
    </Auction>
    <Auction>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>28.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
      <AuctionId>3</AuctionId>
      <Domain>testdomain2.test</Domain>
      <BidPrice>28.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
      <EndTime>2022/04/05 02:20:34 PST</EndTime>
      <EndTimestamp>1649150434049</EndTimestamp>
    </Auction>
  </GetClosedBackorderAuctionsContent>
</GetClosedBackorderAuctionsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
Risposta (formato JSON)
{
  "GetClosedBackorderAuctionsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Auctions": [
      {
        "AuctionWonStatus": "won",
        "YourHighBid": "89.99",
        "YourProxyBid": "1000.0",
        "AuctionId": "2",
        "Domain": "testdomain1.test",
        "BidPrice": "89.99",
        "BidPriceCurrency": "USD",
        "Bids": "1",
        "EndTime": "2022/04/04 02:20:34 PST",
        "EndTimestamp": "1649064034033"
      },
      {
        "AuctionWonStatus": "won",
        "YourHighBid": "28.99",
        "YourProxyBid": "1000.0",
        "AuctionId": "3",
        "Domain": "testdomain2.test",
        "BidPrice": "28.99",
        "BidPriceCurrency": "USD",
        "Bids": "1",
        "EndTime": "2022/04/05 02:20:34 PST",
        "EndTimestamp": "1649150434049"
      }
    ]
  }
}
Richiesta (formato CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
Richiesta Sandbox (formato CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
Risposta (formato CSV)
ok,success,AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid,2,testdomain1.test,4,Closed by Timeout,89.99,USD,1,won,89.99,1000.0,3,testdomain2.test,4,Closed by Timeout,28.99,USD,1,won,28.99,1000.0
 

Comando per ottenere domini scaduti in closeout

Supporto multi-thread
Non supporta API Sandbox

La chiamata al comando Get Expired Closeout Domains restituirà i domini scaduti in closeout. Questo comando è disponibile solo nei formati XML e JSON. Se chiami questo comando, occorre includere i seguenti parametri:

Parametro della richiesta per ottenere i domini Closeout scaduti
Spiegazione
currency(optional)La valuta del risultato restituito, dovrebbe essere "usd", "eur" o "cny", la valuta predefinita è Dollari statunitensi
domain(optional)Aggiungi questo parametro se vuoi cercare un dominio in liquidazione
count_per_page (optional)Quante entità vengono visualizzate per pagina
page_index (optional)Le entità di quale pagina vuoi visualizzare
Tag XML del risultato
Spiegazione
<GetExpiredCloseoutDomainsResponse></GetExpiredCloseoutDomainsResponse>Tag della risposta Get Expired Closeout Domains, è il nodo radice del documento XML di risposta
<GetExpiredCloseoutDomainsHeader></GetExpiredCloseoutDomainsHeader>Ottieni intestazione dei domini scaduti in liquidazione
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetExpiredCloseoutDomainsContent></GetExpiredCloseoutDomainsContent>Tag of content, it's only used when status is "success"
<CloseoutItem></CloseoutItem>Elemento Closeout
<DomainName></DomainName>Il nome di dominio
<DomainNameUtf></DomainNameUtf>Il nome di dominio è in formato utf
<CurrentPrice></CurrentPrice>prezzo attuale
<isIdn></isIdn>Se è il nome di dominio idn
<EndTimeStamp></EndTimeStamp>Data di fine dell'asta in tempo Unix (millisecondi dalla mezzanotte UTC del 1 gennaio 1970)
<RenewalPrice></RenewalPrice>Prezzo di rinnovo
<ExpiredRevenue></ExpiredRevenue>Ricavo del closeout
<DynaAppraisal></DynaAppraisal>DynaAppraisal
<InboundLinks></InboundLinks>Link in entrata del dominio
<MonthlyVisitors></MonthlyVisitors>Visitatori del dominio
<Currency></Currency>Valuta

Esempio di recupero domini scaduti in liquidazione

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_expired_closeout_domains&currency=usd
Richiesta Sandbox (formato XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_expired_closeout_domains&currency=usd
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetExpiredCloseoutDomainsResponse>
  <GetExpiredCloseoutDomainsHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetExpiredCloseoutDomainsHeader>
  <GetExpiredCloseoutDomainsContent>
    <CloseoutItem>
      <DomainName>test.biz</DomainName>
      <DomainNameUtf>test.biz</DomainNameUtf>
      <CurrentPrice>9.91</CurrentPrice>
      <IsIDN>false</IsIDN>
      <EndTimeStamp>0</EndTimeStamp>
      <RenewalPrice>9.99</RenewalPrice>
      <ExpiredRevenue>9.90</ExpiredRevenue>
      <EstibotAppraisal>1223</EstibotAppraisal>
      <InboundLinks>-1</InboundLinks>
      <MonthlyVisitors>-1</MonthlyVisitors>
      <Currency>usd</Currency>
    </CloseoutItem>
  </GetExpiredCloseoutDomainsContent>
</GetExpiredCloseoutDomainsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_expired_closeout_domains&currency=usd
Richiesta Sandbox (formato JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_expired_closeout_domains&currency=usd
Risposta (formato JSON)
{
  "GetExpiredCloseoutDomainsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Size": 1,
    "CloseoutDomains": [
      {
        "closeoutItem": {
          "domainName": "test.biz",
          "domainNameUtf": "test.biz",
          "currentPrice": "9.91",
          "isIdn": false,
          "endTimeStamp": 0,
          "renewalPrice": "9.99",
          "expiredRevenue": "9.90",
          "estibotAppraisal": "1223",
          "inboundLinks": -1,
          "monthlyVisitors": -1,
          "currency": "usd"
        }
      }
    ]
  }
}
 

Comando Buy Expired Closeout Domain

Supporto multi-thread
Non supporta API Sandbox

Chiamando il comando Buy Expired Closeout Domain verrà acquistato il nome di dominio specificato. Questo comando è disponibile solo in formato XML e JSON. Se si chiama questo comando, è necessario includere i seguenti parametri:

Parametro di richiesta per acquisto dominio scaduto in closeout
Spiegazione
domainIl dominio che vuoi acquistare, è possibile inserire solo 1 dominio per richiesta
currency(optional)La valuta del risultato restituito, dovrebbe essere "usd", "eur" o "cny", la valuta predefinita è Dollari statunitensi
Tag XML del risultato
Spiegazione
<BuyExpiredCloseoutDomainResponse></BuyExpiredCloseoutDomainResponse>Tag della risposta Buy Expired Closeout Domain, è il nodo radice del documento XML di risposta
<BuyExpiredCloseoutDomainHeader></BuyExpiredCloseoutDomainHeader>Intestazione Acquista dominio Closeout scaduto
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di acquisto dominio scaduto in closeout

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=buy_expired_closeout_domain&currency=USD&domain=domain.com
Richiesta Sandbox (formato XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=buy_expired_closeout_domain&currency=USD&domain=domain.com
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<BuyExpiredCloseoutDomainResponse>
  <BuyExpiredCloseoutDomainHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </BuyExpiredCloseoutDomainHeader>
</BuyExpiredCloseoutDomainResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=buy_expired_closeout_domain&currency=USD&domain=domain.com
Richiesta Sandbox (formato JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=buy_expired_closeout_domain&currency=USD&domain=domain.com
Risposta (formato JSON)
{
  "BuyExpiredCloseoutDomainResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

Comando Get Listings

Supporto multi-thread
Non supporta API Sandbox

Se si chiama il comando get listings, è necessario includere i seguenti parametri:

Parametro della richiesta Get Listings
Spiegazione
currency (optional)La valuta del risultato restituito, dovrebbe essere "usd", "eur" o "cny", la valuta predefinita è Dollari statunitensi
exclude_pending_sale (optional)If you don't want to get pending sale lock listings, it should be "yes", default is "no"
show_other_registrar (optional)Se vuoi ottenere altre inserzioni di registrar, deve essere "yes", il valore predefinito è "no"
count_per_pageQuante entità vengono visualizzate per pagina. (massimo 20000)
page_indexQuali entità della pagina vuoi visualizzare.
Tag XML del risultato
Spiegazione
<GetListingsResponse></GetListingsResponse>Nodo radice del documento XML di risposta documento XML
<GetListingsHeader></GetListingsHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetListingsContent></GetListingsContent>Contenuto dell'annuncio
<Listing></Listing>Contenuto dell'elemento dell'annuncio
<ListingId></ListingId>ID annuncio
<Domain></Domain>Nome di dominio
<Price></Price>Prezzo
<InBoundLinks></InBoundLinks>Conteggio link in entrata
<Age></Age>Età

Esempio di Get Listings

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&currency=usd&command=get_listings&count_per_page=20&page_index=1
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&currency=usd&command=get_listings&count_per_page=20&page_index=1
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetListingsResponse>
  <GetListingsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetListingsHeader>
  <GetListingsContent>
    <Listing>
      <ListingId>id1</ListingId>
      <Domain>domain_name1</Domain>
      <Price>1</Price>
      <InboundLinks>1</InboundLinks>
      <Age>1</Age>
      <PendingSaleLocked>No</PendingSaleLocked>
      <Type>BIN</Type>
      <RegistrationDate>1791875010217</RegistrationDate>
      <ExpirationDate>1791875010217</ExpirationDate>
    </Listing>
    <Listing>
      <ListingId>id2</ListingId>
      <Domain>domain_name2</Domain>
      <Price>2</Price>
      <InboundLinks>2</InboundLinks>
      <Age>2</Age>
      <PendingSaleLocked>No</PendingSaleLocked>
      <Type>MAKE_OFFER</Type>
      <RegistrationDate>1791875010217</RegistrationDate>
      <ExpirationDate>1791875010217</ExpirationDate>
    </Listing>
  </GetListingsContent>
</GetListingsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&currency=usd&command=get_listings&count_per_page=20&page_index=1
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&currency=usd&command=get_listings&count_per_page=20&page_index=1
Risposta (formato JSON)
{
  "GetListingsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Total": 2,
    "Listing": [
      {
        "ListingId": "id1",
        "Domain": "domain_name1",
        "Price": "1",
        "InboundLinks": "1",
        "Age": "1",
        "PendingSaleLocked": "No",
        "RegistrationDate": 1791875010217,
        "ExpirationDate": 1791875010217,
        "Type": "BIN"
      },
      {
        "ListingId": "id2",
        "Domain": "domain_name2",
        "Price": "2",
        "InboundLinks": "2",
        "Age": "2",
        "PendingSaleLocked": "No",
        "RegistrationDate": 1791875010217,
        "ExpirationDate": 1791875010217,
        "Type": "MAKE_OFFER"
      }
    ]
  }
}
 

Comando per ottenere l'elemento dell'annuncio

Supporto multi-thread
Non supporta API Sandbox

Se si chiama il comando get listing item, è necessario includere i seguenti parametri:

Parametro di richiesta Ottieni elemento annuncio
Spiegazione
domainIl nome di dominio di cui vuoi ottenere i dettagli, è possibile inserire solo 1 dominio per richiesta
currency (optional)La valuta del risultato restituito, dovrebbe essere "usd", "eur" o "cny", la valuta predefinita è Dollari statunitensi
Tag XML del risultato
Spiegazione
<GetListingItemResponse></GetListingItemResponse>Nodo radice del documento XML di risposta documento XML
<GetListingItemHeader></GetListingItemHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetListingsItemContent></GetListingsItemContent>Contenuto dell'annuncio
<Listing></Listing>Contenuto dell'elemento dell'annuncio
<ListingId></ListingId>ID annuncio
<Domain></Domain>Nome di dominio
<Price></Price>Prezzo
<InBoundLinks></InBoundLinks>Conteggio link in entrata
<Age></Age>Età

Esempio di recupero elemento annuncio

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_listing_item&currency=usd&domain=domain_name
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_listing_item&currency=usd&domain=domain_name
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetListingsItemResponse>
  <GetListingsItemHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetListingsItemHeader>
  <GetListingsItemContent>
    <Listing>
      <ListingId>id</ListingId>
      <Domain>domain_name</Domain>
      <Price>0</Price>
      <InboundLinks>0</InboundLinks>
      <Age>0</Age>
      <PendingSaleLocked>No</PendingSaleLocked>
      <Type>BIN</Type>
      <RegistrationDate>1791875010218</RegistrationDate>
      <ExpirationDate>1791875010218</ExpirationDate>
    </Listing>
  </GetListingsItemContent>
</GetListingsItemResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_listing_item&currency=usd&domain=domain_name
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_listing_item&currency=usd&domain=domain_name
Risposta (formato JSON)
{
  "GetListingsItemResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Listing": {
      "ListingId": "id",
      "Domain": "domain_name",
      "Price": "0",
      "InboundLinks": "0",
      "Age": "0",
      "PendingSaleLocked": "No",
      "RegistrationDate": 1791875010218,
      "ExpirationDate": 1791875010218,
      "Type": "BIN"
    }
  }
}
 

Comando Acquista subito

Supporto multi-thread
Non supporta API Sandbox

Se chiami il comando buy it now, i seguenti parametri dovrebbero essere inclusi:

Parametro di richiesta Buy It Now
Spiegazione
domainIl dominio che vuoi acquistare, è possibile inserire solo 1 dominio per richiesta
currency (optional)La valuta del risultato restituito, dovrebbe essere "usd", "eur" o "cny"; se non è stata inserita alcuna valuta, verrà applicata la valuta predefinita dell'account
price_to_verify (optional)Il prezzo buy_it_now previsto da verificare prima dell'acquisto. Se il prezzo effettivo dell'annuncio non corrisponde a questo valore, la richiesta non andrà a buon fine.
Tag XML del risultato
Spiegazione
<BuyItNowResponse></BuyItNowResponse>Nodo radice del documento XML di risposta documento XML
<BuyItNowHeader></BuyItNowHeader>Intestazione della risposta
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<Message></Message>Dovrebbe essere "domain order created", utilizzato solo quando lo stato è "success".

Esempio di Acquisto immediato

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=buy_it_now&domain=domain&currency=usd&price_to_verify=1234
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=buy_it_now&domain=domain&currency=usd&price_to_verify=1234
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<BuyItNowResponse>
  <BuyItNowHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </BuyItNowHeader>
  <BuyItNowContent>
    <OrderId>1</OrderId>
  </BuyItNowContent>
</BuyItNowResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=buy_it_now&domain=domain&currency=usd&price_to_verify=1234
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=buy_it_now&domain=domain&currency=usd&price_to_verify=1234
Risposta (formato JSON)
{
  "BuyItNowResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "OrderId": 1
  }
}
 

Comando Aggiungi nuovo lead

Supporto multi-thread
Non supporta API Sandbox

La chiamata al comando Aggiungi nuovo lead importerà i tuoi lead nel sistema Dynadot con una commissione del 5%.

Nota: il dominio verrà sbloccato per consentire all'acquirente di completare immediatamente l'acquisto all'accettazione.

Questo comando è disponibile solo nei formati XML e JSON. Se chiami questo comando, è necessario includere i seguenti parametri:

Parametro della richiesta Aggiungi nuovo lead
Spiegazione
domain_nameIl nome di dominio per cui vuoi aggiungere un lead; è possibile inserire solo 1 dominio per richiesta
lead_typeil tipo di lead per cui vuoi impostare il lead. I valori accettabili sono "buy_now", "make_offer"
priceil prezzo che vuoi impostare per il lead
buyer_nameil nome degli acquirenti
buyer_emaill'email degli acquirenti
Tag XML del risultato
Spiegazione
<AddNewLeadResponse></AddNewLeadResponse>il nodo radice della risposta
<AddNewLeadHeader></AddNewLeadHeader>Intestazione Aggiungi nuovo lead
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di aggiunta nuovo lead

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=add_new_lead&domains=test.com&lead_type=buy_now&price=1000&buyer_name=test_buyer_name&[email protected]
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=add_new_lead&domains=test.com&lead_type=buy_now&price=1000&buyer_name=test_buyer_name&[email protected]
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<AddNewLeadResponse>
  <AddNewLeadHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </AddNewLeadHeader>
</AddNewLeadResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=add_new_lead&domains=test.com&lead_type=buy_now&price=1000&buyer_name=test_buyer_name&[email protected]
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=add_new_lead&domains=test.com&lead_type=buy_now&price=1000&buyer_name=test_buyer_name&[email protected]
Risposta (formato JSON)
{
  "AddNewLeadResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

Comando Imposta in vendita

Supporto multi-thread
Non supporta API Sandbox

Questo comando supporta il multi-thread.

Chiamare il comando Imposta in vendita elencherà il tuo dominio in vendita nel Marketplace dei domini. Questo comando è disponibile solo in formato XML e JSON. Se chiami questo comando, dovrebbero essere inclusi i seguenti parametri:

Imposta il parametro della richiesta in vendita
Spiegazione
domainsIl dominio che vuoi mettere in vendita nel Domain Marketplace, è possibile inserire solo 1 dominio per richiesta
for_sale_typePuoi scegliere un valore dall'elenco seguente per rappresentare il tuo tipo di vendita:
> mercato:
Elenca il tuo dominio in vendita su Mercato dei Domini. I nuovi annunci di domini saranno impostati sulla categoria, sottocategoria e prezzo inseriti di seguito. Se viene impostato un prezzo effettivo, il dominio sarà disponibile per l'acquisto immediato e push all'acquirente. Maggiori informazioni sul processo di vendita del dominio >

> non_in_vendita:
annulla annuncio
listing_type (optional)Puoi scegliere un valore dall'elenco seguente per rappresentare il tuo tipo di vendita tramite il mercato: (obbligatorio se for_sale_type è marketplace)
> buy_now
Impostare un prezzo fisso renderà il dominio disponibile per l'acquisto immediato e lo invierà all'acquirente.
Nota: per un dominio nel periodo di grazia di aggiunta, se c'è una vendita, potrebbe non essere più cancellato nel periodo di grazia. Maggiori informazioni su Cancellazione in periodo di grazia

> make_offer
Puoi scegliere di impostare un prezzo minimo di offerta o lasciarlo vuoto per consentire qualsiasi importo.
Nota: per un dominio nel periodo di grazia di aggiunta, se c'è una vendita, potrebbe non essere più cancellato nel periodo di grazia. Maggiori informazioni su Cancellazione in periodo di grazia

> buy_now_and_make_offer Impostare un prezzo fisso renderà il dominio disponibile per l'acquisto immediato e invierà una notifica push all'acquirente.
Puoi scegliere di impostare un prezzo minimo di offerta o lasciarlo vuoto per consentire qualsiasi importo.
Nota: per un dominio nel periodo di grazia di aggiunta, se c'è una vendita, potrebbe non essere più cancellato nel periodo di grazia. Maggiori informazioni su Cancellazione in periodo di grazia
price (optional)il prezzo a cui vuoi vendere il tuo dominio. (obbligatorio se for_sale_type è marketplace)
minimum_offer (optional)l'offerta minima che accetterai per il tuo dominio. (obbligatorio se for_sale_type è marketplace)
installment (optional)È consentito il pagamento a rate. Se vuoi abilitare il pagamento a rate, impostalo su "Yes"
maximum_installments (optional)Il numero massimo di rate consentite viene utilizzato solo quando installment è "true"
Puoi scegliere un valore da 2 a 12 per indicare il numero massimo di mesi per il pagamento rateale
category (optional)scegli una categoria per il tuo dominio, puoi consultare la tabella comparativa di Categoria e Sottocategoria qui sotto per la compilazione opzionale.
Sub-category (optional)scegli una sottocategoria per il tuo dominio, puoi fare riferimento alla tabella di confronto Categoria e Sottocategoria qui sotto per la selezione.
Nota: il valore del tuo parametro deve essere il numero corrispondente alla Sottocategoria.
CategoriaSottocategoria
advertisingmarketing
retail
sales
automotivecars_trucks
enthusiasts
motorsports
businessinvestment
law
money
professions
services
careers_educationNo subCategory
consumer_goods_servicesapparel
electronics
entertainmentgames
pop_culture
fashionNo subCategory
financeNo subCategory
gamblingcasino
sports
healthfitness
medicine
internetblogs
ecommerce
domains
web_design
web_hosting
otherNo subCategory
placesafrica
asia
europe
north_america
south_america
real_estateNo subCategory
scienceNo subCategory
societyculture
news
politics
religion
sportsleisure_activities
professional
technologycomputers
uncategorizedNo subCategory
adultNo subCategory
homeNo subCategory
aiNo subCategory
aerospaceNo subCategory
agencyNo subCategory
agriculture_companyNo subCategory
analyticsNo subCategory
alcoholNo subCategory
babies_kidsNo subCategory
biotechNo subCategory
clean_energyNo subCategory
cleaningNo subCategory
communityNo subCategory
construction_organizationNo subCategory
cryptocurrency_blockchainNo subCategory
dating_relationshipNo subCategory
daycareNo subCategory
dentalNo subCategory
droneNo subCategory
e_commerceNo subCategory
food_drinkNo subCategory
furnitureNo subCategory
gamesNo subCategory
insuranceNo subCategory
interior_designNo subCategory
legal_lawNo subCategory
motivationalNo subCategory
manufacturingNo subCategory
marketingNo subCategory
medicalNo subCategory
metaverseNo subCategory
movies_tvNo subCategory
music_audioNo subCategory
news_mediaNo subCategory
nftNo subCategory
outdoorNo subCategory
paymentNo subCategory
petsNo subCategory
politicsNo subCategory
property_managementNo subCategory
recruitment_staffingNo subCategory
servicesNo subCategory
securityNo subCategory
socialNo subCategory
transportationNo subCategory
travelNo subCategory
video_books_magazinesNo subCategory
virtual_realityNo subCategory
website_designNo subCategory
Description (optional)Descrizione del tuo dominio
Tag XML del risultato
Spiegazione
<SetForSaleResponse></SetForSaleResponse>il nodo radice della risposta
<SetForSaleHeader></SetForSaleHeader>Imposta intestazione In vendita
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di messa in vendita

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetForSaleResponse>
  <SetForSaleHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetForSaleHeader>
</SetForSaleResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
Risposta (formato JSON)
{
  "SetForSaleResponse": {
    "ResponseCode: ": "0",
    "Status": "Success"
  }
}
 

Comando elenco domini trasferiti in uscita

Supporto multi-thread
Supporta API Sandbox

Chiamando il Comando Elenco Domini in Trasferimento in Uscita otterrai l'elenco dei domini in trasferimento in uscita in elaborazione. Questo comando è disponibile solo in formato XML e JSON. Se chiami questo comando

Parametro della richiesta di elenco domini di trasferimento in uscita
Spiegazione
Tag XML del risultato
Spiegazione
<TransferOutDomainListResponse></TransferOutDomainListResponse>il nodo radice della risposta
<TransferOutDomainListHeader></TransferOutDomainListHeader>Intestazione dell'elenco dei domini in trasferimento in uscita
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<TransferOutDomainListContent></TransferOutDomainListContent>Intestazione dell'elenco dei domini in trasferimento in uscita
<TransferOutDomainList></TransferOutDomainList>L'elenco dei domini trasferiti in uscita
<Domain></Domain>Il nome di dominio
<OrderId></OrderId>L'ID dell'ordine del dominio trasferito in uscita
<ItemStatus></ItemStatus>Lo stato del trasferimento in uscita del dominio

Esempio di elenco domini per trasferimento in uscita

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=transfer_domain_list
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=transfer_domain_list
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<TransferOutDomainListResponse>
  <TransferOutDomainListHeader>
    <ResponseCode>200</ResponseCode>
    <Status>success</Status>
  </TransferOutDomainListHeader>
  <TransferOutDomainListContent>
    <TransferOutDomainList>
      <TransferOutDomain>
        <OrderId>1</OrderId>
        <Domain>domain1.com</Domain>
        <ItemStatus>Pending</ItemStatus>
      </TransferOutDomain>
    </TransferOutDomainList>
  </TransferOutDomainListContent>
</TransferOutDomainListResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=transfer_domain_list
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=transfer_domain_list
Risposta (formato JSON)
{
  "TransferOutDomainListResponse": {
    "ResponseCode": 200,
    "Status": "success",
    "TransferOutDomainList": [
      {
        "orderId": 1,
        "domain": "domain1.com",
        "itemStatus": "Pending"
      }
    ]
  }
}
 

Imposta comando azione conferma Afternic

Supporto multi-thread
Non supporta API Sandbox

Chiamando il comando Set Afternic Confirm Action verrà impostato il dominio per approvare o disapprovare il trasferimento rapido su Afternic. Questo comando è disponibile solo in formato XML e JSON. Se si chiama questo comando, i seguenti parametri dovrebbero essere inclusi:

Parametro della richiesta Set Afternic Confirm Action
Spiegazione
domainIl dominio per cui vuoi impostare l'azione di conferma del trasferimento rapido di Afternic, è possibile inserire solo 1 dominio per richiesta
actionL'azione che vuoi impostare per la conferma di afternic, dovrebbe essere "confirm_afternic", o "delete_from_afternic"
Tag XML del risultato
Spiegazione
<SetAfternicConfirmActionResponse></SetAfternicConfirmActionResponse>Tag della risposta Set Afternic Confirm Action, è il nodo radice del documento XML di risposta
<SetAfternicConfirmActionHeader></SetAfternicConfirmActionHeader>Imposta l'intestazione dell'azione di conferma Afternic
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione dell'azione di conferma Afternic

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
Richiesta Sandbox (formato XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetAfternicConfirmActionResponse>
  <SetAfternicConfirmActionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetAfternicConfirmActionHeader>
</SetAfternicConfirmActionResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
Richiesta Sandbox (formato JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
Risposta (formato JSON)
{
  "SetAfternicConfirmActionResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

Imposta comando azione di conferma Sedo

Supporto multi-thread
Non supporta API Sandbox

Chiamare il comando Set Sedo Confirm Action imposterà il dominio per approvare o disapprovare il fast-transfer su Sedo. Questo comando è disponibile solo in formato XML e JSON. Se si chiama questo comando, i seguenti parametri dovrebbero essere inclusi:

Imposta parametro richiesta azione di conferma Sedo
Spiegazione
domainIl dominio per cui vuoi impostare l'azione di conferma del trasferimento rapido Sedo, è possibile inserire solo 1 dominio per richiesta
actionL'azione che vuoi impostare per la conferma sedo, dovrebbe essere "confirm_sedo", o "delete_from_sedo"
Tag XML del risultato
Spiegazione
<SetSedoConfirmActionResponse></SetSedoConfirmActionResponse>Tag della risposta Set Sedo Confirm Action, è il nodo radice del documento XML di risposta
<SetSedoConfirmActionHeader></SetSedoConfirmActionHeader>Imposta l'header dell'azione di conferma Sedo
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"

Esempio di impostazione dell'azione di conferma Sedo

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
Richiesta Sandbox (formato XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetSedoConfirmActionResponse>
  <SetSedoConfirmActionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetSedoConfirmActionHeader>
</SetSedoConfirmActionResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
Richiesta Sandbox (formato JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
Risposta (formato JSON)
{
  "SetSedoConfirmActionResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

Comando Get Whois Stats

Supporto multi-thread
Supporta API Sandbox

Chiamando il comando Get Whois Stats otterrai le statistiche whois. Questo comando è disponibile solo in formato XML e JSON. Se chiami questo comando, devono essere inclusi i seguenti parametri:

Parametro della richiesta Get Whois Stats
Spiegazione
domain_nameIl nome di dominio per cui devi configurare DNSSEC
date_typePuoi scegliere un campo dal seguente elenco per rappresentare il tuo tipo di data:
last_7_days, last_30_days, current_year, last_year
Tag XML del risultato
Spiegazione
<GetWhoisStatsResponse></GetWhoisStatsResponse>il nodo radice della risposta
<GetWhoisStatsHeader></GetWhoisStatsHeader>Intestazione delle statistiche Whois
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetWhoisStatsContent></GetWhoisStatsContent>contenuto della risposta
<WhoisStats></WhoisStats>Contiene più insiemi di dati statistici whois
<WhoisStat></WhoisStat>Dati specifici delle statistiche Whois
<Date></Date>Intervallo di tempo minimo
<Count></Count>Conteggio dei whois nell'intervallo di tempo corrente

Esempio di ottenimento delle statistiche Whois

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_whois_stats&domain_name=domain1.com&date_type=last_7_days
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_whois_stats&domain_name=domain1.com&date_type=last_7_days
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetWhoisStatsResponse>
  <GetWhoisStatsHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetWhoisStatsHeader>
  <GetWhoisStatsContent>
    <WhoisStats>
      <WhoisStat>
        <Date>2023-11-04</Date>
        <Count>200</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-05</Date>
        <Count>300</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-06</Date>
        <Count>100</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-07</Date>
        <Count>200</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-08</Date>
        <Count>300</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-09</Date>
        <Count>100</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-10</Date>
        <Count>200</Count>
      </WhoisStat>
    </WhoisStats>
  </GetWhoisStatsContent>
</GetWhoisStatsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_whois_stats&domain_name=domain1.com&date_type=last_7_days
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_whois_stats&domain_name=domain1.com&date_type=last_7_days
Risposta (formato JSON)
{
  "GetWhoisStatsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "WhoisStats": [
      {
        "Date": "2023-11-04",
        "Count": 200
      },
      {
        "Date": "2023-11-05",
        "Count": 300
      },
      {
        "Date": "2023-11-06",
        "Count": 100
      },
      {
        "Date": "2023-11-07",
        "Count": 200
      },
      {
        "Date": "2023-11-08",
        "Count": 300
      },
      {
        "Date": "2023-11-09",
        "Count": 100
      },
      {
        "Date": "2023-11-10",
        "Count": 200
      }
    ]
  }
}
 

Comando elenco ordini

Supporto multi-thread
Supporta API Sandbox

Chiamando il comando Order List si ottiene l'elenco degli ordini. Questo comando è disponibile solo in formato XML e JSON. Se si chiama questo comando, occorre includere i seguenti parametri:

Parametro di richiesta elenco ordini
Spiegazione
search_byPuoi scegliere un valore dal seguente elenco per rappresentare il tipo di ricerca: date_range, domain, order_id
start_datela data di inizio della tua query nel formato yyyy/MM/dd
end_datela data di fine della tua query nel formato yyyy/MM/dd
payment_methodPuoi scegliere più valori dall'elenco seguente per indicare il tuo metodo di pagamento:
nessun_saldo
Saldo del conto
carta_di_credito
vaglia_postale
Paypal
Moneybooker
bonifico_bancario
Alipay
payflow_credit_card2 (non più utilizzato)
wechat_pay
ecash
bonifico bancario
apple_pay
verifica_conto
vendita
union_pay
account PayPal
mercado_pago
Payoneer
ma usa la virgola per separare più valori, ad esempio: account_balance,credit_card
Tag XML del risultato
Spiegazione
<OrderListResponse></OrderListResponse>il nodo radice della risposta
<OrderListHeader></OrderListHeader>Intestazione elenco ordini
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<OrderListContent></OrderListContent>Intestazione elenco ordini
<OrderList></OrderList>Contiene più set di dati di log degli ordini
<OrderItem></OrderItem>Contiene i dati del log di un singolo ordine
<OrderItemDomain></OrderItemDomain>Il nome di dominio che include gli elementi in questo ordine
<OrderId></OrderId>Contiene l'ID dell'ordine
<SubmittedDate></SubmittedDate>Contiene la data in cui l'ordine è stato inviato
<Cost></Cost>Contiene il costo dell'ordine
<Status></Status>Contiene lo stato dell'ordine

Esempio di lista ordini

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<OrderListResponse>
  <OrderListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </OrderListHeader>
  <OrderListContent>
    <OrderList>
      <Order>
        <OrderId>123456</OrderId>
        <SubmittedDate>1791875010219</SubmittedDate>
        <Currency>USD</Currency>
        <PaymentMethod>Account Balance</PaymentMethod>
        <TotalCost>$8.00</TotalCost>
        <TotalPaid>$8.00</TotalPaid>
        <Status>Problem</Status>
        <OrderItem>
          <ItemType>Domain Registration</ItemType>
          <Name>test.com</Name>
          <Duration>1</Duration>
          <Cost>2.99</Cost>
          <Status>Completed</Status>
        </OrderItem>
        <OrderItem>
          <ItemType>Domain Renewal</ItemType>
          <Name>test1.ac</Name>
          <Duration>1</Duration>
          <Cost>3.99</Cost>
          <Status>Completed</Status>
        </OrderItem>
        <OrderItem>
          <ItemType>Domain Transfer</ItemType>
          <Name>test2.de</Name>
          <Duration>1</Duration>
          <Cost>4.99</Cost>
          <Status>Completed</Status>
        </OrderItem>
        <OrderItem>
          <ItemType>Domain Registration</ItemType>
          <Name>test3.gg</Name>
          <Duration>1</Duration>
          <Cost>5.99</Cost>
          <Status>Completed</Status>
        </OrderItem>
        <OrderItem>
          <ItemType>Domain Renewal</ItemType>
          <Name>test4.uk</Name>
          <Duration>1</Duration>
          <Cost>6.99</Cost>
          <Status>Completed</Status>
        </OrderItem>
        <OrderItem>
          <ItemType>Domain Transfer</ItemType>
          <Name>test5.net</Name>
          <Duration>1</Duration>
          <Cost>7.99</Cost>
          <Status>Completed</Status>
        </OrderItem>
      </Order>
      <Order>
        <OrderId>123457</OrderId>
        <SubmittedDate>1791875010219</SubmittedDate>
        <Currency>EUR</Currency>
        <PaymentMethod>Paypal</PaymentMethod>
        <TotalCost>$100.00</TotalCost>
        <TotalPaid>$100.00</TotalPaid>
        <Status>Submitted</Status>
      </Order>
    </OrderList>
  </OrderListContent>
</OrderListResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
Risposta (formato JSON)
{
  "OrderListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "OrderList": [
      {
        "OrderId": "123456",
        "SubmittedDate": "2026/10/13",
        "Currency": "USD",
        "PaymentMethod": "Account Balance",
        "TotalCost": "$8.00",
        "TotalPaid": "$8.00",
        "Status": "Problem",
        "ItemList": [
          {
            "ItemType": "Domain Registration",
            "Name": "test.com",
            "Duration": 1,
            "Cost": "2.99",
            "Status": "Completed"
          },
          {
            "ItemType": "Domain Renewal",
            "Name": "test1.ac",
            "Duration": 1,
            "Cost": "3.99",
            "Status": "Completed"
          },
          {
            "ItemType": "Domain Transfer",
            "Name": "test2.de",
            "Duration": 1,
            "Cost": "4.99",
            "Status": "Completed"
          },
          {
            "ItemType": "Domain Registration",
            "Name": "test3.gg",
            "Duration": 1,
            "Cost": "5.99",
            "Status": "Completed"
          },
          {
            "ItemType": "Domain Renewal",
            "Name": "test4.uk",
            "Duration": 1,
            "Cost": "6.99",
            "Status": "Completed"
          },
          {
            "ItemType": "Domain Transfer",
            "Name": "test5.net",
            "Duration": 1,
            "Cost": "7.99",
            "Status": "Completed"
          }
        ]
      },
      {
        "OrderId": "123457",
        "SubmittedDate": "2026/10/13",
        "Currency": "EUR",
        "PaymentMethod": "Paypal",
        "TotalCost": "$100.00",
        "TotalPaid": "$100.00",
        "Status": "Submitted",
        "ItemList": []
      }
    ]
  }
}
 

Comando per ottenere lo stato dell'ordine

Supporto multi-thread
Supporta API Sandbox

Chiamando il comando Get Order Status otterrai lo stato dell'ordine. Questo comando è disponibile solo in formato XML e JSON. Se chiami questo comando, dovrebbero essere inclusi i seguenti parametri:

Parametro di richiesta per ottenere lo stato dell'ordine
Spiegazione
order_idL'id dell'ordine da interrogare
Tag XML del risultato
Spiegazione
<GetOrderStatusResponse></GetOrderStatusResponse>il nodo radice della risposta
<GetOrderStatusHeader></GetOrderStatusHeader>Intestazione per ottenere lo stato dell'ordine
<ResponseCode></ResponseCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<GetOrderStatusContent></GetOrderStatusContent>contenuto della risposta
<OrderId></OrderId>ID ordine
<OrderStatus></OrderStatus>stato dell'ordine( Shopping, Submitted, Waitpay, Processing, Completed, Problem, Deleted, Cancelled )
<ItemTypeName></ItemTypeName>Tipo di elemento
<ItemName></ItemName>Nome elemento
<ItemStatus></ItemStatus>Stato dell'articolo(Completato, Annullato, Problema)

Esempio di Get Order Status

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_order_status&order_id=0
Richiesta Sandbox (formato XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_order_status&order_id=0
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetOrderStatusResponse>
  <GetOrderStatusHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetOrderStatusHeader>
  <GetOrderStatusContent>
    <OrderId>0</OrderId>
    <OrderStatus>Completed</OrderStatus>
    <Item>
      <ItemTypeName>domain transfer away</ItemTypeName>
      <ItemName>&amp;</ItemName>
      <ItemStatus>transfer.com</ItemStatus>
    </Item>
    <Item>
      <ItemTypeName>domain</ItemTypeName>
      <ItemName>&amp;</ItemName>
      <ItemStatus>register.com</ItemStatus>
    </Item>
  </GetOrderStatusContent>
</GetOrderStatusResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_order_status&order_id=0
Richiesta Sandbox (formato JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_order_status&order_id=0
Risposta (formato JSON)
{
  "GetOrderStatusResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "OrderStatus": {
      "OrderId": 0,
      "OrderStatus": "Completed",
      "ItemList": [
        {
          "ItemTypeName": "domain transfer away",
          "ItemName": "transfer.com",
          "ItemStatus": "Completed"
        },
        {
          "ItemTypeName": "domain",
          "ItemName": "register.com",
          "ItemStatus": "Completed"
        }
      ]
    }
  }
}
 

Comando in elaborazione

Supporto multi-thread
Supporta API Sandbox

Chiamare il comando is_processing ti dirà se è sicuro inviare una nuova richiesta

Parametro di richiesta Is-Processing
Spiegazione
non è necessario alcun parametro aggiuntivo
Tag XML del risultato
Spiegazione
<Response></Response>Tag della risposta is_processing
<ResponseHeader></ResponseHeader>Tag dell'header is_processing
<ResponseMsg></ResponseMsg>Tag of is_processing response message. It should be "yes"(There is a process in the system. You shouldn't sent another request.) or "no"(There is no any process for you account. It is safe to submit a new request.)

Esempio di elaborazione in corso

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=is_processing
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=is_processing
Risposta (formato XML)
<Response>
  <ResponseHeader>
    <ResponseCode>0</ResponseCode>
    <ResponseMsg>yes</ResponseMsg>
  </ResponseHeader>
</Response>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=is_processing
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=is_processing
Risposta (formato JSON)
{
   "Response":{
      "ResponseCode":"0",
      "ResponseMsg":"no"
   }
}
Richiesta (formato CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=is_processing
Richiesta Sandbox (formato CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=is_processing
Risposta (formato CSV)
ok,yes
 

Comando per elencare i coupon

Supporto multi-thread
Supporta API Sandbox

Chiamando il comando List Coupons si otterranno tutti i coupon. Questo comando è disponibile solo in formato XML e JSON. Se si chiama questo comando, è necessario includere i seguenti parametri:

Parametro di richiesta per elencare i coupon
Spiegazione
coupon_typePuoi scegliere un valore dalla seguente lista per rappresentare il tuo tipo di ricerca: "registration" , "renewal" , o "transfer"
Tag XML del risultato
Spiegazione
<ListCouponsResponse></ListCouponsResponse>il nodo radice della risposta
<ListCouponsHeader></ListCouponsHeader>Intestazione elenco coupon
<SuccessCode></SuccessCode>Se l'operazione ha successo, "0" per successo, "-1" per fallimento
<Status></Status>Lo stato della richiesta
<Error></Error>Informazioni sull'errore della richiesta, usate solo quando lo stato è "error"
<ListCouponsContent></ListCouponsContent>Contenuto di List Coupons
<Coupons></Coupons>Contiene più set di dati coupon
<Coupon></Coupon>Contiene i dati di un singolo coupon
<Code></Code>Codice coupon
<Description></Description>Descrizione del coupon
<CouponType></CouponType>Tipo di coupon
<DiscountType></DiscountType>Tipo di sconto offerto dal coupon
<DiscountInfo></DiscountInfo>Le informazioni sullo sconto del coupon
<Percentage></Percentage>La percentuale dello sconto
<AUD></AUD>Importo dello sconto in dollari australiani
<MXN></MXN>Importo dello sconto in Pesos messicani
<EUR></EUR>Importo dello sconto in euro
<GBP></GBP>Importo dello sconto in sterline britanniche
<IDR></IDR>Importo dello sconto in Rupie indonesiane
<USD></USD>Importo dello sconto in dollari statunitensi
<CAD></CAD>Importo dello sconto in dollari canadesi
<INR></INR>Importo dello sconto in rupie indiane
<BRL></BRL>Importo sconto in Real brasiliano
<CNY></CNY>Importo dello sconto in yuan cinesi
<Restriction></Restriction>Restrizioni coupon
<PriceLevels></PriceLevels>Una raccolta di livelli di prezzo che supportano l'uso dei coupon
<UsesPerAccount></UsesPerAccount>Il numero di volte in cui il coupon può essere utilizzato per account
<UsesSystemWide></UsesSystemWide>Il numero di volte in cui il coupon può essere utilizzato a livello di sistema
<UsesPerIp></UsesPerIp>Il numero di volte in cui il coupon può essere utilizzato per ogni indirizzo IP
<ItemsPerAccount></ItemsPerAccount>Il numero di elementi per cui il coupon può essere utilizzato per account
<ItemsSystemWide></ItemsSystemWide>Il numero di elementi per cui il coupon può essere utilizzato a livello di sistema
<ItemsPerOrder></ItemsPerOrder>Il numero di articoli per cui il coupon può essere utilizzato per ordine
<ItemsPerDay></ItemsPerDay>Il numero di articoli per cui il coupon può essere utilizzato al giorno
<IdnRestriction></IdnRestriction>Restrizioni IDN per il coupon
<DomainDurationMin></DomainDurationMin>Durata minima del dominio
<DomainDurationMax></DomainDurationMax>Durata massima del dominio
<Tlds></Tlds>Una raccolta di domini di primo livello che supportano l'uso dei coupon
<Tld></Tld>Un singolo dominio di primo livello che supporta l'uso dei coupon
<Currencies></Currencies>Una raccolta di tipi di valuta che supportano l'uso dei coupon
<Currency></Currency>Un singolo tipo di valuta che supporta l'uso dei coupon
<StartDate></StartDate>La data di inizio della validità del coupon
<EndDate></EndDate>La data di fine validità del coupon

Esempio di elenco dei coupon

Richiesta (formato XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=list_coupons&coupon_type=renewal
Richiesta Sandbox (formato XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=list_coupons&coupon_type=renewal
Risposta (formato XML)
<?xml version="1.0" encoding="UTF-8"?>
<ListCouponsResponse>
  <ListCouponsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </ListCouponsHeader>
  <ListCouponsContent>
    <Coupons>
      <Coupon>
        <Code>DOMAINRENEW1</Code>
        <Description>Domain Renew Coupon</Description>
        <CouponType>Hosting/SSL Coupons</CouponType>
        <DiscountType>PERCENTAGE_OFF</DiscountType>
        <DiscountInfo>
          <Percentage>10%</Percentage>
        </DiscountInfo>
        <Restriction>
          <PriceLevels>Any</PriceLevels>
          <IdnRestriction>None</IdnRestriction>
          <DomainDurationMin>1</DomainDurationMin>
          <DomainDurationMax>1</DomainDurationMax>
          <Tlds>
            <Tld>.com</Tld>
            <Tld>.net</Tld>
            <Tld>.org</Tld>
          </Tlds>
          <Currencies>
            <Currency>US Dollar USD ($)</Currency>
          </Currencies>
        </Restriction>
        <StartDate>1476811260000</StartDate>
        <EndDate>1483257540000</EndDate>
      </Coupon>
    </Coupons>
  </ListCouponsContent>
</ListCouponsResponse>
Richiesta (formato JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=list_coupons&coupon_type=renewal
Richiesta Sandbox (formato JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=list_coupons&coupon_type=renewal
Risposta (formato JSON)
{
  "ListCouponsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Coupons": [
      {
        "Code": "DOMAINRENEW1",
        "Description": "Domain Renew Coupon",
        "CouponType": "Hosting/SSL Coupons",
        "DiscountType": "PERCENTAGE_OFF",
        "DiscountInfo": {
          "Percentage": "10%"
        },
        "Restriction": {
          "PriceLevels": "Any",
          "IdnRestriction": "None",
          "DomainDurationMin": "1",
          "DomainDurationMax": "1",
          "Tlds": [
            ".com",
            ".net",
            ".org"
          ],
          "Currencies": [
            "US Dollar USD ($)"
          ]
        },
        "StartDate": "1476811260000",
        "EndDate": "1483257540000"
      }
    ]
  }
}