chore(oas): [8/n] improve oas schemas (#9163)

Improve OAS schemas [8/n]
This commit is contained in:
Shahed Nasser
2024-09-17 20:26:41 +03:00
committed by GitHub
parent cda5bbac78
commit 78eaed70e5
20 changed files with 95 additions and 85 deletions

View File

@@ -1,20 +1,20 @@
/**
* @schema AdminPostExchangesShippingActionReqSchema
* type: object
* description: SUMMARY
* description: The details of the shipping method to update.
* x-schemaName: AdminPostExchangesShippingActionReqSchema
* properties:
* custom_amount:
* type: number
* title: custom_amount
* description: The exchange's custom amount.
* description: The shipping method's custom amount.
* internal_note:
* type: string
* title: internal_note
* description: The exchange's internal note.
* description: A note viewed by admin users only.
* metadata:
* type: object
* description: The exchange's metadata.
* description: The exchange's metadata, can hold custom key-value pairs.
*
*/

View File

@@ -1,7 +1,7 @@
/**
* @schema AdminPostExchangesShippingReqSchema
* type: object
* description: SUMMARY
* description: The outbound shipping method's details.
* x-schemaName: AdminPostExchangesShippingReqSchema
* required:
* - shipping_option_id
@@ -9,22 +9,22 @@
* shipping_option_id:
* type: string
* title: shipping_option_id
* description: The exchange's shipping option id.
* description: The ID of the associated shipping option.
* custom_amount:
* type: number
* title: custom_amount
* description: The exchange's custom amount.
* description: Set a custom amount for the shipping method.
* description:
* type: string
* title: description
* description: The exchange's description.
* description: The shipping method's description.
* internal_note:
* type: string
* title: internal_note
* description: The exchange's internal note.
* description: A note viewed by admin users only.
* metadata:
* type: object
* description: The exchange's metadata.
* description: The exchange's metadata, can hold custom key-value pairs.
*
*/

View File

@@ -1,7 +1,7 @@
/**
* @schema AdminPostOrderClaimsReqSchema
* type: object
* description: SUMMARY
* description: The claim's details.
* x-schemaName: AdminPostOrderClaimsReqSchema
* required:
* - type
@@ -16,7 +16,7 @@
* order_id:
* type: string
* title: order_id
* description: The claim's order id.
* description: The ID of the order the claim is created for.
* description:
* type: string
* title: description
@@ -24,14 +24,14 @@
* internal_note:
* type: string
* title: internal_note
* description: The claim's internal note.
* description: A note viewed only by admin users.
* reason_id:
* type: string
* title: reason_id
* description: The claim's reason id.
* description: The ID of the associated return reason.
* metadata:
* type: object
* description: The claim's metadata.
* description: The claim's metadata, can hold custom key-value pairs.
*
*/

View File

@@ -1,15 +1,15 @@
/**
* @schema AdminPostOrderEditsAddItemsReqSchema
* type: object
* description: SUMMARY
* description: The details of items to be edited.
* x-schemaName: AdminPostOrderEditsAddItemsReqSchema
* properties:
* items:
* type: array
* description: The order edit's items.
* description: The details of items to be edited.
* items:
* type: object
* description: The item's items.
* description: An item's details.
* required:
* - variant_id
* - quantity
@@ -17,7 +17,7 @@
* variant_id:
* type: string
* title: variant_id
* description: The item's variant id.
* description: The ID of the associated product variant.
* quantity:
* type: number
* title: quantity
@@ -29,14 +29,14 @@
* internal_note:
* type: string
* title: internal_note
* description: The item's internal note.
* description: A note viewed only by admin users.
* allow_backorder:
* type: boolean
* title: allow_backorder
* description: The item's allow backorder.
* description: Whether the item can be added even if there's no available invenotory quantity of the variant.
* metadata:
* type: object
* description: The item's metadata.
* description: The item's metadata, can hold custom key-value pairs.
*
*/

View File

@@ -1,17 +1,17 @@
/**
* @schema AdminPostOrderEditsItemsActionReqSchema
* type: object
* description: SUMMARY
* description: The details to update in the item.
* x-schemaName: AdminPostOrderEditsItemsActionReqSchema
* properties:
* quantity:
* type: number
* title: quantity
* description: The order edit's quantity.
* description: The item's quantity.
* internal_note:
* type: string
* title: internal_note
* description: The order edit's internal note.
* description: A note viewed only by admin users.
*
*/

View File

@@ -1,7 +1,7 @@
/**
* @schema AdminPostOrderEditsReqSchema
* type: object
* description: SUMMARY
* description: The order edit's details.
* x-schemaName: AdminPostOrderEditsReqSchema
* required:
* - order_id
@@ -9,7 +9,7 @@
* order_id:
* type: string
* title: order_id
* description: The order edit's order id.
* description: The ID of the order this edit is for.
* description:
* type: string
* title: description
@@ -17,10 +17,10 @@
* internal_note:
* type: string
* title: internal_note
* description: The order edit's internal note.
* description: A note viewed only by admin users.
* metadata:
* type: object
* description: The order edit's metadata.
* description: The order edit's metadata, can hold custom key-value pairs.
*
*/

View File

@@ -1,20 +1,20 @@
/**
* @schema AdminPostOrderEditsShippingActionReqSchema
* type: object
* description: SUMMARY
* description: The shipping method's details.
* x-schemaName: AdminPostOrderEditsShippingActionReqSchema
* properties:
* custom_amount:
* type: number
* title: custom_amount
* description: The order edit's custom amount.
* description: Set a custom price for the shipping method.
* internal_note:
* type: string
* title: internal_note
* description: The order edit's internal note.
* description: A note viewed only by admin users.
* metadata:
* type: object
* description: The order edit's metadata.
* description: The order edit's metadata, can hold custom key-value pairs.
*
*/

View File

@@ -1,7 +1,7 @@
/**
* @schema AdminPostOrderEditsShippingReqSchema
* type: object
* description: SUMMARY
* description: The shipping method's details.
* x-schemaName: AdminPostOrderEditsShippingReqSchema
* required:
* - shipping_option_id
@@ -9,22 +9,22 @@
* shipping_option_id:
* type: string
* title: shipping_option_id
* description: The order edit's shipping option id.
* description: The ID of the associated shipping option.
* custom_amount:
* type: number
* title: custom_amount
* description: The order edit's custom amount.
* description: Set a custom price for the shipping method.
* description:
* type: string
* title: description
* description: The order edit's description.
* description: The shipping method's description.
* internal_note:
* type: string
* title: internal_note
* description: The order edit's internal note.
* description: A note viewed only by admin users.
* metadata:
* type: object
* description: The order edit's metadata.
* description: The shipping method's metadata, can hold custom key-value pairs.
*
*/

View File

@@ -1,7 +1,7 @@
/**
* @schema AdminPostOrderEditsUpdateItemQuantityReqSchema
* type: object
* description: SUMMARY
* description: The order item's details to update.
* x-schemaName: AdminPostOrderEditsUpdateItemQuantityReqSchema
* required:
* - quantity
@@ -9,11 +9,11 @@
* quantity:
* type: number
* title: quantity
* description: The order edit's quantity.
* description: The item's quantity.
* internal_note:
* type: string
* title: internal_note
* description: The order edit's internal note.
* description: A note viewed only by admin users.
*
*/

View File

@@ -1,7 +1,7 @@
/**
* @schema AdminPostOrderExchangesReqSchema
* type: object
* description: SUMMARY
* description: The exchange's details.
* x-schemaName: AdminPostOrderExchangesReqSchema
* required:
* - order_id
@@ -9,7 +9,7 @@
* order_id:
* type: string
* title: order_id
* description: The exchange's order id.
* description: The ID of the order this exchange is created for.
* description:
* type: string
* title: description
@@ -17,10 +17,10 @@
* internal_note:
* type: string
* title: internal_note
* description: The exchange's internal note.
* description: A note viewed only by admin users.
* metadata:
* type: object
* description: The exchange's metadata.
* description: The exchange's metadata, can hold custom key-value pairs.
*
*/

View File

@@ -1,20 +1,20 @@
/**
* @schema AdminPostReceiveReturnsReqSchema
* type: object
* description: SUMMARY
* description: The return receival details.
* x-schemaName: AdminPostReceiveReturnsReqSchema
* properties:
* internal_note:
* type: string
* title: internal_note
* description: The return's internal note.
* description: A note viewed only by admin users.
* description:
* type: string
* title: description
* description: The return's description.
* metadata:
* type: object
* description: The return's metadata.
* description: The return's metadata, can hold custom key-value pairs.
*
*/

View File

@@ -1,13 +1,13 @@
/**
* @schema AdminPostReturnsConfirmRequestReqSchema
* type: object
* description: SUMMARY
* description: The confirmation's details.
* x-schemaName: AdminPostReturnsConfirmRequestReqSchema
* properties:
* no_notification:
* type: boolean
* title: no_notification
* description: The return's no notification.
* description: Whether to send the customer a notification about the confirmation.
*
*/

View File

@@ -1,17 +1,17 @@
/**
* @schema AdminPostReturnsDismissItemsActionReqSchema
* type: object
* description: SUMMARY
* description: The details to update of the damaged item.
* x-schemaName: AdminPostReturnsDismissItemsActionReqSchema
* properties:
* quantity:
* type: number
* title: quantity
* description: The return's quantity.
* description: The item's quantity.
* internal_note:
* type: string
* title: internal_note
* description: The return's internal note.
* description: A note viewed only by admin users.
*
*/

View File

@@ -1,17 +1,17 @@
/**
* @schema AdminPostReturnsReceiveItemsActionReqSchema
* type: object
* description: SUMMARY
* description: The details of the received item.
* x-schemaName: AdminPostReturnsReceiveItemsActionReqSchema
* properties:
* quantity:
* type: number
* title: quantity
* description: The return's quantity.
* description: The item's quantity.
* internal_note:
* type: string
* title: internal_note
* description: The return's internal note.
* description: A note viewed only by admin users.
*
*/

View File

@@ -1,15 +1,15 @@
/**
* @schema AdminPostReturnsReceiveItemsReqSchema
* type: object
* description: SUMMARY
* description: The items details.
* x-schemaName: AdminPostReturnsReceiveItemsReqSchema
* properties:
* items:
* type: array
* description: The return's items.
* description: The items details.
* items:
* type: object
* description: The item's items.
* description: An item's details.
* required:
* - id
* - quantity
@@ -17,7 +17,7 @@
* id:
* type: string
* title: id
* description: The item's ID.
* description: The ID of the item in the order.
* quantity:
* type: number
* title: quantity
@@ -29,7 +29,7 @@
* internal_note:
* type: string
* title: internal_note
* description: The item's internal note.
* description: A note viewed only by admin users.
*
*/

View File

@@ -1,7 +1,7 @@
/**
* @schema AdminPostReturnsReqSchema
* type: object
* description: SUMMARY
* description: The return's details.
* x-schemaName: AdminPostReturnsReqSchema
* required:
* - order_id
@@ -9,11 +9,11 @@
* order_id:
* type: string
* title: order_id
* description: The return's order id.
* description: The ID of the order the return belongs to.
* location_id:
* type: string
* title: location_id
* description: The return's location id.
* description: The ID of the location the items are returned to.
* description:
* type: string
* title: description
@@ -21,14 +21,14 @@
* internal_note:
* type: string
* title: internal_note
* description: The return's internal note.
* description: A note viewed only by admin users.
* no_notification:
* type: boolean
* title: no_notification
* description: The return's no notification.
* description: Whether to send the customer a notification about the created return.
* metadata:
* type: object
* description: The return's metadata.
* description: The return's metadata, can hold custom key-value pairs.
*
*/

View File

@@ -1,24 +1,24 @@
/**
* @schema AdminPostReturnsRequestItemsActionReqSchema
* type: object
* description: SUMMARY
* description: The details to update in the item.
* x-schemaName: AdminPostReturnsRequestItemsActionReqSchema
* properties:
* quantity:
* type: number
* title: quantity
* description: The claim's quantity.
* description: The item's quantity.
* internal_note:
* type: string
* title: internal_note
* description: The claim's internal note.
* description: A note viewed only by admin users.
* reason_id:
* type: string
* title: reason_id
* description: The claim's reason id.
* description: The ID of the associated return reason.
* metadata:
* type: object
* description: The claim's metadata.
* description: The claim's metadata, can hold custom key-value pairs.
*
*/

View File

@@ -1,15 +1,15 @@
/**
* @schema AdminPostReturnsRequestItemsReqSchema
* type: object
* description: SUMMARY
* description: The items' details.
* x-schemaName: AdminPostReturnsRequestItemsReqSchema
* properties:
* items:
* type: array
* description: The claim's items.
* description: The items' details.
* items:
* type: object
* description: The item's items.
* description: An item's details.
* required:
* - id
* - quantity
@@ -29,14 +29,14 @@
* internal_note:
* type: string
* title: internal_note
* description: The item's internal note.
* description: A note viewed only by admin users.
* reason_id:
* type: string
* title: reason_id
* description: The item's reason id.
* description: The ID of the associated return reason.
* metadata:
* type: object
* description: The item's metadata.
* description: The item's metadata, can hold custom key-value pairs.
*
*/