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

关于Dynadot

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

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

使用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 复制代码

<?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)

XML 复制代码

{

  "SetForSaleResponse": {

    "ResponseCode: ": "0",

    "Status": "Success"

  }

}