asyavee/medusa-store
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

docs: fix OAS generator + generate OAS (#11584)

Browse Source
This commit is contained in:
Shahed Nasser
2025-02-24 15:30:38 +02:00
committed by GitHub
parent 41f070be9a
commit be566ca6fb
44 changed files with 10904 additions and 8753 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
www/apps/api-reference/specs/admin/components/schemas/AdminCreateProduct.yaml
View File

@@ -3,7 +3,6 @@ description: The product's details.
x-schemaName: AdminCreateProduct
required:
- title
- shipping_profile_id
- options
properties:
title:

249
www/apps/api-reference/specs/admin/components/schemas/AdminDraftOrder.yaml Normal file
View File

@@ -0,0 +1,249 @@
type: object
description: The draft order's details.
x-schemaName: AdminDraftOrder
required:
- payment_collections
- items
- shipping_methods
- status
- currency_code
- id
- version
- region_id
- customer_id
- sales_channel_id
- email
- payment_status
- fulfillment_status
- summary
- created_at
- updated_at
- original_item_total
- original_item_subtotal
- original_item_tax_total
- item_total
- item_subtotal
- item_tax_total
- original_total
- original_subtotal
- original_tax_total
- total
- subtotal
- tax_total
- discount_total
- discount_tax_total
- gift_card_total
- gift_card_tax_total
- shipping_total
- shipping_subtotal
- shipping_tax_total
- original_shipping_total
- original_shipping_subtotal
- original_shipping_tax_total
properties:
payment_collections:
type: array
description: The draft order's payment collections.
items:
$ref: ./AdminPaymentCollection.yaml
fulfillments:
type: array
description: The draft order's fulfillments.
items:
$ref: ./AdminOrderFulfillment.yaml
sales_channel:
$ref: ./AdminSalesChannel.yaml
customer:
$ref: ./AdminCustomer.yaml
shipping_address:
$ref: ./AdminOrderAddress.yaml
billing_address:
$ref: ./AdminOrderAddress.yaml
items:
type: array
description: The draft order's items.
items:
$ref: ./AdminOrderLineItem.yaml
shipping_methods:
type: array
description: The draft order's shipping methods.
items:
$ref: ./AdminOrderShippingMethod.yaml
status:
type: string
title: status
description: The draft order's status.
currency_code:
type: string
title: currency_code
description: The draft order's currency code.
example: usd
id:
type: string
title: id
description: The draft order's ID.
version:
type: number
title: version
description: The draft order's version.
region_id:
type: string
title: region_id
description: The ID of the region associated with the draft order.
customer_id:
type: string
title: customer_id
description: The ID of the customer that the draft order belongs to.
sales_channel_id:
type: string
title: sales_channel_id
description: The ID of the sales channel that the draft order is placed in.
email:
type: string
title: email
description: The customer email associated with the draft order.
format: email
display_id:
type: number
title: display_id
description: The draft order's display ID.
payment_status:
type: string
description: The draft order's payment status.
enum:
- not_paid
- awaiting
- authorized
- partially_authorized
- canceled
- captured
- partially_captured
- partially_refunded
- refunded
- requires_action
fulfillment_status:
type: string
description: The draft order's fulfillment status.
enum:
- canceled
- not_fulfilled
- partially_fulfilled
- fulfilled
- partially_shipped
- shipped
- partially_delivered
- delivered
transactions:
type: array
description: The draft order's transactions.
items:
$ref: ./BaseOrderTransaction.yaml
summary:
$ref: ./BaseOrderSummary.yaml
metadata:
type: object
description: The draft order's metadata, can hold custom key-value pairs.
created_at:
type: string
format: date-time
title: created_at
description: The date the draft order was created.
updated_at:
type: string
format: date-time
title: updated_at
description: The date the draft order was updated.
original_item_total:
type: number
title: original_item_total
description: >-
The total of the draft order's items including taxes, excluding
promotions.
original_item_subtotal:
type: number
title: original_item_subtotal
description: >-
The total of the draft order's items excluding taxes, including
promotions.
original_item_tax_total:
type: number
title: original_item_tax_total
description: The tax total of the draft order's items excluding promotions.
item_total:
type: number
title: item_total
description: The total of the draft order's items including taxes and promotions.
item_subtotal:
type: number
title: item_subtotal
description: >-
The total of the draft order's items excluding taxes, including
promotions.
item_tax_total:
type: number
title: item_tax_total
description: The tax total of the draft order's items including promotions.
original_total:
type: number
title: original_total
description: The draft order's total excluding promotions, including taxes.
original_subtotal:
type: number
title: original_subtotal
description: The draft order's total excluding taxes, including promotions.
original_tax_total:
type: number
title: original_tax_total
description: The draft order's tax total, excluding promotions.
total:
type: number
title: total
description: The draft order's total including taxes and promotions.
subtotal:
type: number
title: subtotal
description: The draft order's total excluding taxes, including promotions.
tax_total:
type: number
title: tax_total
description: The draft order's tax total including promotions.
discount_total:
type: number
title: discount_total
description: The draft order's discount or promotions total.
discount_tax_total:
type: number
title: discount_tax_total
description: The tax total of draft order's discount or promotion.
gift_card_total:
type: number
title: gift_card_total
description: The draft order's gift card total.
gift_card_tax_total:
type: number
title: gift_card_tax_total
description: The tax total of the draft order's gift card.
shipping_total:
type: number
title: shipping_total
description: The draft order's shipping total including taxes and promotions.
shipping_subtotal:
type: number
title: shipping_subtotal
description: The draft order's shipping total excluding taxes, including promotions.
shipping_tax_total:
type: number
title: shipping_tax_total
description: The tax total of the draft order's shipping.
original_shipping_total:
type: number
title: original_shipping_total
description: The draft order's shipping total including taxes, excluding promotions.
original_shipping_subtotal:
type: number
title: original_shipping_subtotal
description: The draft order's shipping total excluding taxes, including promotions.
original_shipping_tax_total:
type: number
title: original_shipping_tax_total
description: The tax total of the draft order's shipping excluding promotions.

26
www/apps/api-reference/specs/admin/components/schemas/AdminDraftOrderListResponse.yaml Normal file
View File

@@ -0,0 +1,26 @@
type: object
description: The list of draft orders with pagination fields.
x-schemaName: AdminDraftOrderListResponse
required:
- limit
- offset
- count
- draft_orders
properties:
limit:
type: number
title: limit
description: The maximum number of items retrieved.
offset:
type: number
title: offset
description: The number of items skipped before retrieving the returned items.
count:
type: number
title: count
description: The total count of items available.
draft_orders:
type: array
description: The list of draft orders.
items:
$ref: ./AdminDraftOrder.yaml

2
www/apps/api-reference/specs/admin/components/schemas/AdminDraftOrderResponse.yaml
View File

@@ -5,4 +5,4 @@ required:
- draft_order
properties:
draft_order:
$ref: ./AdminOrder.yaml
$ref: ./AdminDraftOrder.yaml

108
www/apps/api-reference/specs/admin/components/schemas/AdminUpdateDraftOrder.yaml Normal file
View File

@@ -0,0 +1,108 @@
type: object
description: The data to update in the draft order.
x-schemaName: AdminUpdateDraftOrder
properties:
email:
type: string
title: email
description: The customer email associated with the draft order.
format: email
shipping_address:
type: object
description: The draft order's shipping address.
properties:
first_name:
type: string
title: first_name
description: The shipping address's first name.
last_name:
type: string
title: last_name
description: The shipping address's last name.
phone:
type: string
title: phone
description: The shipping address's phone.
company:
type: string
title: company
description: The shipping address's company.
address_1:
type: string
title: address_1
description: The first address line.
address_2:
type: string
title: address_2
description: The second address line.
city:
type: string
title: city
description: The shipping address's city.
country_code:
type: string
title: country_code
description: The shipping address's country code.
example: us
province:
type: string
title: province
description: The shipping address's province.
postal_code:
type: string
title: postal_code
description: The shipping address's postal code.
metadata:
type: object
description: The shipping address's metadata, can hold custom key-value pairs.
billing_address:
type: object
description: The draft order's billing address.
properties:
first_name:
type: string
title: first_name
description: The billing address's first name.
last_name:
type: string
title: last_name
description: The billing address's last name.
phone:
type: string
title: phone
description: The billing address's phone.
company:
type: string
title: company
description: The billing address's company.
address_1:
type: string
title: address_1
description: The first address line.
address_2:
type: string
title: address_2
description: The second address line.
city:
type: string
title: city
description: The billing address's city.
country_code:
type: string
title: country_code
description: The billing address's country code.
example: us
province:
type: string
title: province
description: The billing address's province.
postal_code:
type: string
title: postal_code
description: The billing address's postal code.
metadata:
type: object
description: The billing address's metadata, can hold custom key-value pairs.
metadata:
type: object
description: The draft order's metadata, can hold custom key-value pairs.

67
www/apps/api-reference/specs/admin/components/schemas/BaseOrderSummary.yaml
View File

@@ -2,49 +2,14 @@ type: object
description: The order's summary details.
x-schemaName: BaseOrderSummary
required:
- total
- subtotal
- total_tax
- ordered_total
- fulfilled_total
- returned_total
- return_request_total
- write_off_total
- pending_difference
- current_order_total
- original_order_total
- transaction_total
- paid_total
- refunded_total
- accounting_total
properties:
total:
type: number
title: total
description: The order's total including taxes and promotions.
subtotal:
type: number
title: subtotal
description: The order's total excluding taxes, including promotions.
total_tax:
type: number
title: total_tax
description: The order's total taxes.
ordered_total:
type: number
title: ordered_total
description: The order's total when it was placed.
fulfilled_total:
type: number
title: fulfilled_total
description: The total of the fulfilled items of the order.
returned_total:
type: number
title: returned_total
description: The total of the order's returned items.
return_request_total:
type: number
title: return_request_total
description: The total of the items requested to be returned.
write_off_total:
type: number
title: write_off_total
description: The total of the items removed from the order.
paid_total:
type: number
title: paid_total
@@ -53,3 +18,25 @@ properties:
type: number
title: refunded_total
description: The total amount refunded.
pending_difference:
type: number
title: pending_difference
description: >-
The difference pending to be processed. If negative, the customer needs a
refund. Otherwise, additional payment is required from the customer.
current_order_total:
type: number
title: current_order_total
description: The order's current total, could be the total after a change in the order.
original_order_total:
type: number
title: original_order_total
description: The order's original total.
transaction_total:
type: number
title: transaction_total
description: The total of the transactions made on the order.
accounting_total:
type: number
title: accounting_total
description: The order's total without the credit-line total.

2
www/apps/api-reference/specs/admin/components/schemas/BasePaymentCollection.yaml
View File

@@ -59,6 +59,8 @@ properties:
- awaiting
- authorized
- partially_authorized
- completed
- failed
payment_providers:
type: array
description: >-

20
www/apps/api-reference/specs/admin/components/schemas/BasePaymentSession.yaml
View File

@@ -1,6 +1,13 @@
type: object
description: The payment session's details.
x-schemaName: BasePaymentSession
required:
- id
- amount
- currency_code
- provider_id
- data
- status
properties:
id:
type: string
@@ -26,7 +33,7 @@ properties:
payment.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/commerce-modules/payment/payment-session#data-property
https://docs.medusajs.com/resources/commerce-modules/payment/payment-session#data-property
context:
type: object
description: The context around the payment, such as the customer's details.
@@ -37,12 +44,12 @@ properties:
type: string
description: The payment session's status.
enum:
- error
- authorized
- captured
- canceled
- captured
- pending
- requires_more
- error
authorized_at:
type: string
title: authorized_at
@@ -52,10 +59,3 @@ properties:
type: object
payment:
$ref: ./BasePayment.yaml
required:
- id
- amount
- currency_code
- provider_id
- data
- status

5
www/apps/api-reference/specs/admin/components/schemas/OrderTransaction.yaml
View File

@@ -4,6 +4,7 @@ x-schemaName: OrderTransaction
required:
- id
- order_id
- version
- order
- amount
- currency_code
@@ -59,3 +60,7 @@ properties:
description: The date that the transaction was updated.
order:
type: object
version:
type: number
title: version
description: The order version that the transaction belongs to.

7
www/apps/api-reference/specs/admin/components/schemas/StoreCartShippingOption.yaml
View File

@@ -14,6 +14,7 @@ required:
- amount
- prices
- calculated_price
- insufficient_inventory
properties:
id:
type: string
@@ -101,3 +102,9 @@ properties:
$ref: ./StorePrice.yaml
calculated_price:
$ref: ./StoreCalculatedPrice.yaml
insufficient_inventory:
type: boolean
title: insufficient_inventory
description: >-
Whether the shipping option's location doesn't have sufficient quantity
for any of the cart's items.