使用API有效率地管理Dynadot域名，出售账户中的域名

关于Dynadot

Dynadot是通过ICANN认证的域名注册商，自2002年成立以来，服务于全球108个国家和地区的客户，为数以万计的客户提供简洁，优惠，安全的域名注册以及管理服务。

Dynadot平台操作教程索引（包括域名邮箱，解析，建站，优惠长期更新）

 Dynadot.com提供的API是专为效率而构建的高级域名管理和获取工具包。在Dynadot平台上，我们提供了50多个命令来设置，管理，注册和竞标域名。

在了具体的功能API代码前，请阅读关于Dynadot的API使用须知。

使用Dynadot API，可以在Dynadot市场中出售您当前持有的域名。

命令参数

如果发售出域名的命令，则须包含下列参数：

请求出售参数	解释
domains	您想在域名市场上列出要出售的域名，请每次只输入1个域名。
for_sale_type	您可以从以下列表中选择一个值来表示您的销售类型： > marketplace： 在域名市场上列出您的域名出售信息。新的域名列表将被设置为以下输入的类别、子类别和价格。如果设置了实际价格，则域名将立即可购买并推送给买家。 有关域名销售流程的更多信息 > > not_for_sale： 取消销售
listing_type (optional)	以下是用来表示您在市场上的销售类型的选项列表：（如果for_sale_type是marketplace时必填） > buy_now 设置固定价格将使该域名立即可供购买，并推送给买家。 > make_offer 您可以选择设置最低报价或留空以接受任何报价金额。 >  buy_now_and_make_offer 设置固定价格将使该域名立即可供购买并推送给买家。 您可以选择设置最低报价或留空以接受任何报价金额。 注意：对于处于添加宽限期的域名，如果发生交易，该域名可能不再被宽限删除。
price (optional)	您希望出售您的域名的价格。 （for_sale_type是marketplace时必填）
minimum_offer (optional)	您对您的域名接受的最低报价。(for_sale_type是marketplace时必填)
installment (optional)	是否允许分期付款的。如果要启用分期付款，请将其设置为"yes"
maximum_installments (optional)	最大允许的分期付款数，仅在允许分期付款时使用。您可以选择一个值从2到12来代表分期付款的最大期数。
category (optional)	为您的域名选择类型。
Sub-category (optional)	为您的域名选择子类型。您可以参考下面的类别和子类别对照表进行选择。
Description (optional)	您的领域描述

在成功发送设置域名售出信息的命令之后，返回的结果将以XML、JSON格式的标签返回，其中XML的结果标签所代表含义由下图所示：

XML结果标签	解释
<SetForSaleResponse></SetForSaleResponse>	响应的根节点
<SetForSaleHeader></SetForSaleHeader>	设置待售标题
<ResponseCode></ResponseCode>	如果操作成功，则为成功的"0"，失败的"-1"
<Status></Status>	请求状态
<Error></Error>	请求的错误信息仅在状态为“错误”时使用

可表述的域名类型：

域名类型	域名子类型
advertising	marketing
	retail
	sales
automotive	cars_trucks
	enthusiasts
	motorsports
business	investment
	law
	money
	professions
	services
careers_education	No subCategory
consumer_goods_services	apparel
	electronics
entertainment	games
	pop_culture
fashion	No subCategory
finance	No subCategory
gambling	casino
	sports
health	fitness
	medicine
internet	blogs
	ecommerce
	domains
	web_design
	web_hosting
other	No subCategory
places	africa
	asia
	europe
	north_america
	south_america
real_estate	No subCategory
science	No subCategory
society	culture
	news
	politics
	religion
sports	leisure_activities
	professional
technology	computers
uncategorized	No subCategory
adult	No subCategory
home	No subCategory
ai	No subCategory
aerospace	No subCategory
agency	No subCategory
agriculture_company	No subCategory
analytics	No subCategory
alcohol	No subCategory
babies_kids	No subCategory
biotech	No subCategory
clean_energy	No subCategory
cleaning	No subCategory
community	No subCategory
construction_organization	No subCategory
cryptocurrency_blockchain	No subCategory
dating_relationship	No subCategory
daycare	No subCategory
dental	No subCategory
drone	No subCategory
e_commerce	No subCategory
food_drink	No subCategory
furniture	No subCategory
games	No subCategory
insurance	No subCategory
interior_design	No subCategory
legal_law	No subCategory
motivational	No subCategory
manufacturing	No subCategory
marketing	No subCategory
medical	No subCategory
metaverse	No subCategory
movies_tv	No subCategory
music_audio	No subCategory
news_media	No subCategory
nft	No subCategory
outdoor	No subCategory
payment	No subCategory
pets	No subCategory
politics	No subCategory
property_management	No subCategory
recruitment_staffing	No subCategory
services	No subCategory
security	No subCategory
social	No subCategory
transportation	No subCategory
travel	No subCategory
video_books_magazines	No subCategory
virtual_reality	No subCategory
website_design	No subCategory

示例

此处，使用API命令设置售出某一域名。域名为test.com，类型为一口价域名，价格为1000，可最多分为四期进行付款，域名类型为健康，子类型为健身，描述为testdescription。

将高级域API请求发送到以下URL：https://api.dynadot.com/api3.xml。

equest (XML format)

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

Response (XML format)

<?xml version="1.0" encoding="UTF-8"?>

<SetForSaleResponse>

  <SetForSaleHeader>

    <ResponseCode>0</ResponseCode>

    <Status>success</Status>

  </SetForSaleHeader>

</SetForSaleResponse>

Request (JSON format)

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

Response (JSON format)

{

  "SetForSaleResponse": {

    "ResponseCode: ": "0",

    "Status": "Success"

  }

}