# 获取指定时间段的订单列表

检索订单列表，按最早到最晚创建日期排列。

Endpoint: POST /v3/project/{project_id}/admin/order/search
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    项目ID。您可以在您的发布商帐户项目名称旁边找到。
    Example: 44056

## Request fields (application/json):

  - `created_date_from` (string)
    订单创建时间段的开始日期或日期加时间（[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) 格式）。
    Example: "2020-04-15T18:16:00+05:00"

  - `created_date_until` (string)
    订单创建时间段的结束日期或日期加时间（[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)格式）。
    Example: "2020-04-16T18:16:00+05:00"

  - `limit` (integer)
    响应中包含的订单数量限制。

  - `offset` (integer)
    订单编号，从该元素开始生成列表（从0开始数）。

## Response 200 fields (application/json):

  - `has_more` (boolean)
    是否还有任何附加页面。
    Example: true

  - `orders` (array)
    订单列表。

  - `orders.coupons` (array,null)
    对订单应用的优惠券列表。

  - `orders.coupons.code` (string)
    使用的优惠券代码。唯一且区分大小写的代码。包含字母和数字。

  - `orders.coupons.coupon_id` (integer)
    优惠券ID，由艾克索拉在创建优惠券促销活动时生成。

  - `orders.coupons.sku` (string)
    优惠券SKU，由艾克索拉在创建优惠券促销活动时生成。

  - `orders.coupons.type` (string)
    优惠券类型。
    Enum: "unique_catalog_offer", "coupon", "promocode"

  - `orders.date_created` (string)
    订单创建日期或日期加时间代码（[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)格式）。
    Example: "2020-08-11T10:00:00+03:00"

  - `orders.invoice_id` (string)
    发票ID。

  - `orders.is_free` (boolean)
    该订单是否免费。

  - `orders.items` (array)
    商品列表。

  - `orders.items.description` (object,null)
    包含商品信息的对象。

  - `orders.items.description.description` (string)
    商品描述。

  - `orders.items.description.image_url` (string)
    商品图片URL。

  - `orders.items.description.name` (string)
    商品名称。

  - `orders.items.is_bonus` (boolean)
    该商品是否为奖励。

  - `orders.items.is_free` (boolean)
    该商品是否免费。

  - `orders.items.item_id` (integer)
    商品ID。由艾克索拉在创建商品时生成。
    Example: 1

  - `orders.items.order_item_id` (integer)
    订单中的商品ID。由艾克索拉在订单创建期间生成。

  - `orders.items.price` (object,null)
    商品价格。

  - `orders.items.price.amount` (string)
    折扣后的商品价格。
    Example: "30"

  - `orders.items.price.amount_without_discount` (string)
    不含折扣的商品价格。
    Example: "30"

  - `orders.items.price.currency` (string)
    虚拟货币的SKU或[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)标准下的三字母代码。请查看文档详细了解[艾克索拉支持的货币](https://developers.xsolla.com/zh/doc/pay-station/references/supported-currencies/)。
    Example: "USD"

  - `orders.items.price.is_virtual_currency` (boolean)
    该货币是否是虚拟货币。

  - `orders.items.quantity` (integer)
    商品数量。
    Example: 1

  - `orders.items.region_id` (integer,null)
    商品可用区域的ID。请参阅[文档](https://developers.xsolla.com/zh/doc/shop-builder/features/regional-restrictions/)了解区域销售限制的更多信息。

  - `orders.items.sku` (string)
    创建商品时指定的商品ID。 SKU只能包含大小写英文字母和数字字符、句点、破折号和下划线。
    Example: "elven_shield"

  - `orders.items.tax_category` (string)
    征税类别。
    Example: "DG00002"

  - `orders.items.type` (string)
    商品类型。
    Enum: "virtual_good", "virtual_currency", "bundle", "game_key", "physical_good", "value_point"

  - `orders.mode` (string)
    订单创建模式。
    Enum: "default", "sandbox"

  - `orders.order_id` (integer)
    订单ID。
    Example: 1

  - `orders.price` (object,null)
    订单价格。

  - `orders.price.amount` (string)
    最终订单价格。
    Example: "30"

  - `orders.price.amount_without_discount` (string)
    不含折扣的订单价格。
    Example: "30"

  - `orders.price.currency` (string)
    虚拟货币的SKU或真实货币按照[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)格式的三字母代码。请查看文档详细了解[艾克索拉支持的货币](https://developers.xsolla.com/zh/doc/pay-station/references/supported-currencies/)。
    Example: "USD"

  - `orders.project_id` (integer)
    项目ID。您可以在您的[发布商帐户](https://publisher.xsolla.com/)项目名称旁边找到。
    Example: 44056

  - `orders.promotions` (array,null)
    对订单应用的促销活动列表。

  - `orders.promotions.promotion_id` (integer)
    项目内的促销活动ID。
    Example: 111425

  - `orders.status` (string)
    订单状态。
    Enum: "new", "paid", "done", "canceled", "expired"

  - `orders.user` (object)

  - `orders.user.country` (string)
    [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)标准下的两个大写字母的国家/地区代码。 请查看文档详细了解[艾克索拉支持的国家/地区](https://developers.xsolla.com/zh/doc/shop-builder/references/supported-countries/)。
    Example: "US"

  - `orders.user.email` (string)
    用户电子邮箱，使用符合[RFC 822](https://www.w3.org/Protocols/rfc822/#z8)协议的格式。
    Example: "user@xsolla.com"

  - `orders.user.id` (string)
    创建订单时传递的用户ID。
    Example: "07e653a2b15011e6818f005056a54369"

  - `orders.user.region_id` (integer,null)
    用户所在区域的ID，设置了区域销售限制时返回。创建订单时传入的用户国家/地区，与[创建区域](https://developers.xsolla.com/zh/zh/api/shop-builder/operation/admin-create-region/)时指定的国家/地区列表进行匹配，具体请参见[文档](https://developers.xsolla.com/zh/doc/shop-builder/features/regional-restrictions/)了解有关区域销售限制的更多信息。
    Example: 12

  - `total_items_count` (integer)
    指定时间段内的订单总数。
    Example: 1

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

  - `statusCode` (integer)
    Example: 401