> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subotiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取折扣详情

> 获取折扣详情



## OpenAPI

````yaml openapi/v1-zh.yaml GET /api/v1/discount/{id}
openapi: 3.0.3
info:
  title: Subotiz API
  description: Subotiz OpenAPI
  version: 1.0.0
servers:
  - url: https://{api}.subotiz.com
    variables:
      api:
        default: api
security:
  - sec0: []
tags:
  - name: 折扣
    description: 折扣
  - name: 发票
    description: 发票
  - name: 退款
    description: 退款
  - name: 商品管理
    description: 商品管理
  - name: 订阅
    description: 订阅
  - name: 商品定价
    description: 商品定价方案
  - name: 交易单
    description: 交易单
  - name: 支付流水
    description: 支付流水
  - name: 结账会话
    description: 结账会话
  - name: 顾客
    description: 顾客
  - name: 顾客门户
    description: 顾客门户
  - name: Webhook
    description: Webhook
  - name: 争议
    description: 争议订单
paths:
  /api/v1/discount/{id}:
    get:
      tags:
        - 折扣
      summary: 获取折扣详情
      description: 获取折扣详情
      operationId: v1-discount-get-discount
      parameters:
        - name: id
          in: path
          description: 折扣 ID
          required: true
          schema:
            type: string
        - $ref: '#/components/parameters/HeaderRequestID'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetDiscountResponse'
components:
  parameters:
    HeaderRequestID:
      name: Request-Id
      in: header
      description: 请求的唯一标识符
      required: true
      schema:
        type: string
        default: 008e3967-a1b5-48bb-be14-d5bff5092e61
  schemas:
    GetDiscountResponse:
      type: object
      properties:
        code:
          type: string
          description: error code
        message:
          type: string
          description: error message
        data:
          $ref: '#/components/schemas/GetDiscountResponse_Data'
      description: 查询折扣响应
    GetDiscountResponse_Data:
      type: object
      properties:
        id:
          type: string
          description: 折扣对象的唯一 ID
        discount_name:
          type: string
          description: 折扣名称
        status:
          type: string
          description: |-
            折扣状态：
             - draft：折扣已创建但尚未激活或对用户可见
             - not_started：折扣已定义，但其开始时间尚未到达
             - ongoing：折扣当前处于活动状态并可供使用
             - completed：折扣已结束，不再可供使用
        discount_code:
          type: string
          description: 在结账时应用的折扣代码
        discount_method:
          type: string
          description: |-
            折扣方式：仅当设置为 "discount_code" 时才能使用折扣代码：
             - discount_code：通过折扣代码折扣
        starts_at:
          type: string
          description: 折扣开始时间（UTC 格式），空字符串表示无限制
        ends_at:
          type: string
          description: 折扣结束时间（UTC 格式），空字符串表示无限制
        created_at:
          type: string
          description: 创建时间，UTC 格式字符串
        updated_at:
          type: string
          description: 最后更新时间，UTC 格式字符串
      description: 查询折扣响应
  securitySchemes:
    sec0:
      type: http
      description: 'Bearer API Key 鉴权。格式：Authorization: Bearer {your_api_key}'
      scheme: bearer

````