使用API有效率地管理Dynadot域名，查看某一订单当前的状态

news2024/9/24 11:22:04

前言

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

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

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

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

使用Dynadot API，可以查询用户账户下的某一订单的状态。

命令参数

如果发送对查看订单信息命令，则须包含下列参数：

获取订单状态请求参数	解释
order_id	要查询的订单ID

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

XML结果标签	解释
<GetOrderStatusResponse></GetOrderStatusResponse>	响应的根节点
<GetOrderStatusHeader></GetOrderStatusHeader>	获取订单状态标题
<ResponseCode></ResponseCode>	如果操作成功，则为成功的"0"，失败的"-1"
<Status></Status>	请求状态
<Error></Error>	请求的错误信息仅在状态为“错误”时使用
<GetOrderStatusContent></GetOrderStatusContent>	响应内容
<OrderId></OrderId>	订单编号
<OrderStatus></OrderStatus>	订单状态（购物中，已提交，等待付款，处理中，已完成，问题，已删除，已取消）
<ItemTypeName></ItemTypeName>	项目类型
<ItemName></ItemName>	项目名称
<ItemStatus></ItemStatus>	项目状态（已完成、已取消、问题）

示例

此处，查看某一订单信息。

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

Request (XML format)

https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_order_status&order_id=0

Response (XML format)

<?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>&</ItemName>

      <ItemStatus>transfer.com</ItemStatus>

    </Item>

    <Item>

      <ItemTypeName>domain</ItemTypeName>

      <ItemName>&</ItemName>

      <ItemStatus>register.com</ItemStatus>

    </Item>

  </GetOrderStatusContent>

</GetOrderStatusResponse>

Request (JSON format)

https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_order_status&order_id=0

Response (JSON format)

{

  "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"

        }

      ]

    }

  }

}

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

XML格式