使用API有效率地管理Dynadot域名，查看账户过往订单信息

前言

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

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

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

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

使用Dynadot API，可以查看当前用户在Dynadot平台的历史交易名单信息。

命令参数

如果发送查询Dynadot历史订单的命令，则须包含下列参数：

订购列表请求参数	解释
search_by	您可以从以下列表中选择一个值来代表您的搜索类型：date_range、domain、order_id
start_date	您的查询开始日期的格式为yyyy/MM/dd
end_date	您的查询的结束日期格式为yyyy/MM/dd
payment_method	您可以从以下列表中选择多个值来表示您的付款方式： none_balance account_balance credit_card money_order paypal moneybookers bank_wire alipay payflow_credit_card2（已不再使用） wechat_pay ecash bank_transfer apple_pay checking_account sale union_pay paypal_account mercado_pago payoneer 但请使用逗号来分隔多个值，例如：account_balance,credit_card。

在成功发送查看域名历史订单信息的命令之后，返回的结果将以XML、CSV或是JSON格式的标签返回，其中XML的结果标签所代表含义由下图所示：

XML结果标签	解释
<OrderListResponse></OrderListResponse>	响应的根节点
<OrderListHeader></OrderListHeader>	订购清单标题
<ResponseCode></ResponseCode>	如果操作成功，则为成功的"0"，失败的"-1"
<Status></Status>	请求状态
<Error></Error>	请求的错误信息仅在状态为“错误”时使用
<OrderListContent></OrderListContent>	订购清单标题
<OrderList></OrderList>	包含多个订单日志数据集
<OrderItem></OrderItem>	包含单个订单日志数据
<OrderItemDomain></OrderItemDomain>	包含按照此顺序的域名
<OrderId></OrderId>	包含订单的ID
<SubmittedDate></SubmittedDate>	包含订单提交的日期
<Cost></Cost>	包含订单的成本
<Status></Status>	包含订单状态

示例

此处，使用API查询用户在dynadot的历史交易信息。

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

在网页中，其显示样式如下：（示例为实际操作。）

Request (XML format)

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

Response (XML format)

<?xml version="1.0" encoding="UTF-8"?>
<OrderListResponse>
  <OrderListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </OrderListHeader>
  <OrderListContent>
    <OrderList>
      <Order>
        <OrderId>123456</OrderId>
        <SubmittedDate>1725514506547</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>1725514506547</SubmittedDate>
        <Currency>EUR</Currency>
        <PaymentMethod>Paypal</PaymentMethod>
        <TotalCost>$100.00</TotalCost>
        <TotalPaid>$100.00</TotalPaid>
        <Status>Submitted</Status>
      </Order>
    </OrderList>
  </OrderListContent>
</OrderListResponse>

Request (JSON format)

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

Response (JSON format)

{

  "OrderListResponse": {

    "ResponseCode": 0,

    "Status": "success",

    "OrderList": [

      {

        "OrderId": "123456",

        "SubmittedDate": "2024/09/04",

        "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": "2024/09/04",

        "Currency": "EUR",

        "PaymentMethod": "Paypal",

        "TotalCost": "$100.00",

        "TotalPaid": "$100.00",

        "Status": "Submitted",

        "ItemList": []

      }

    ]

  }

}

XML格式

JSON格式