chore(docs): Generated API Reference (#3262)

Co-authored-by: olivermrbl <olivermrbl@users.noreply.github.com>
This commit is contained in:
github-actions[bot]
2023-02-14 20:32:28 +02:00
committed by GitHub
co-authored by olivermrbl
parent 67f9429293
commit 4fb22e8ba5
122 changed files with 8682 additions and 3866 deletions
+69 -27
View File
@@ -6,41 +6,70 @@ description: >-
may also be created when processing Swaps and Claims.
type: object
required:
- allow_discounts
- cart_id
- claim_order_id
- created_at
- description
- fulfilled_quantity
- has_shipping
- id
- is_giftcard
- is_return
- metadata
- order_edit_id
- order_id
- original_item_id
- quantity
- returned_quantity
- shipped_quantity
- should_merge
- swap_id
- thumbnail
- title
- unit_price
- quantity
- updated_at
- variant_id
properties:
id:
description: The line item's ID
type: string
description: The cart's ID
example: item_01G8ZC9GWT6B2GP5FSXRXNFNGN
cart_id:
description: The ID of the Cart that the Line Item belongs to.
nullable: true
type: string
example: cart_01G8ZH853Y6TFXWPG5EYE81X63
cart:
description: A cart object. Available if the relation `cart` is expanded.
nullable: true
type: object
order_id:
description: The ID of the Order that the Line Item belongs to.
nullable: true
type: string
example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
order:
description: An order object. Available if the relation `order` is expanded.
nullable: true
type: object
swap_id:
description: The id of the Swap that the Line Item belongs to.
nullable: true
type: string
example: null
swap:
description: A swap object. Available if the relation `swap` is expanded.
nullable: true
type: object
claim_order_id:
description: The id of the Claim that the Line Item belongs to.
nullable: true
type: string
example: null
claim_order:
description: A claim order object. Available if the relation `claim_order` is expanded.
nullable: true
type: object
tax_lines:
description: Available if the relation `tax_lines` is expanded.
@@ -52,6 +81,18 @@ properties:
type: array
items:
$ref: ./LineItemAdjustment.yaml
original_item_id:
description: The id of the original line item
nullable: true
type: string
order_edit_id:
description: The ID of the order edit to which a cloned item belongs
nullable: true
type: string
order_edit:
description: The order edit joined. Available if the relation `order_edit` is expanded.
nullable: true
type: object
title:
description: >-
The title of the Line Item, this should be easily identifiable by the
@@ -60,35 +101,38 @@ properties:
example: Medusa Coffee Mug
description:
description: A more detailed description of the contents of the Line Item.
nullable: true
type: string
example: One Size
thumbnail:
description: A URL string to a small image of the contents of the Line Item.
nullable: true
type: string
format: uri
example: https://medusa-public-images.s3.eu-west-1.amazonaws.com/coffee-mug.png
is_return:
description: Is the item being returned
type: boolean
example: false
default: false
is_giftcard:
description: Flag to indicate if the Line Item is a Gift Card.
type: boolean
example: false
default: false
should_merge:
description: >-
Flag to indicate if new Line Items with the same variant should be merged
or added as an additional Line Item.
type: boolean
example: false
default: true
allow_discounts:
description: >-
Flag to indicate if the Line Item should be included when doing discount
calculations.
type: boolean
example: false
default: true
has_shipping:
description: Flag to indicate if the Line Item has fulfillment associated with it.
nullable: true
type: boolean
example: false
unit_price:
@@ -96,31 +140,36 @@ properties:
The price of one unit of the content in the Line Item. This should be in
the currency defined by the Cart/Order/Swap/Claim that the Line Item
belongs to.
type: boolean
type: integer
example: 8000
variant_id:
description: The id of the Product Variant contained in the Line Item.
nullable: true
type: string
example: variant_01G1G5V2MRX2V3PVSR2WXYPFB6
variant:
description: >-
A product variant object. The Product Variant contained in the Line Item.
Available if the relation `variant` is expanded.
type: object
nullable: true
$ref: ./ProductVariant.yaml
quantity:
description: The quantity of the content in the Line Item.
type: integer
example: 1
fulfilled_quantity:
description: The quantity of the Line Item that has been fulfilled.
nullable: true
type: integer
example: 0
returned_quantity:
description: The quantity of the Line Item that has been returned.
nullable: true
type: integer
example: 0
shipped_quantity:
description: The quantity of the Line Item that has been shipped.
nullable: true
type: integer
example: 0
refundable:
@@ -130,55 +179,48 @@ properties:
type: integer
example: 0
subtotal:
type: integer
description: The subtotal of the line item
type: integer
example: 8000
tax_total:
type: integer
description: The total of tax of the line item
type: integer
example: 0
total:
type: integer
description: The total amount of the line item
type: integer
example: 8000
original_total:
type: integer
description: The original total amount of the line item
type: integer
example: 8000
original_tax_total:
type: integer
description: The original tax total amount of the line item
type: integer
example: 0
discount_total:
type: integer
description: The total of discount of the line item
type: integer
example: 0
gift_card_total:
type: integer
description: The total of the gift card of the line item
type: integer
example: 0
includes_tax:
description: '[EXPERIMENTAL] Indicates if the line item unit_price include tax'
type: boolean
original_item_id:
description: '[EXPERIMENTAL] The id of the original line item'
type: string
order_edit_id:
description: '[EXPERIMENTAL] The ID of the order edit to which a cloned item belongs'
type: string
order_edit:
description: '[EXPERIMENTAL] The order edit joined'
type: object
default: false
created_at:
type: string
description: The date with timezone at which the resource was created.
type: string
format: date-time
updated_at:
type: string
description: The date with timezone at which the resource was updated.
type: string
format: date-time
metadata:
type: object
description: An optional key-value map with additional details
nullable: true
type: object
example:
car: white