chore(docs): Updated API Reference (v2) (#9552)

Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action

Co-authored-by: Oli Juhl <59018053+olivermrbl@users.noreply.github.com>
Co-authored-by: Shahed Nasser <27354907+shahednasser@users.noreply.github.com>
This commit is contained in:
github-actions[bot]
2024-10-14 11:00:04 +00:00
committed by GitHub
parent 43324b9294
commit b40fa6353e
37 changed files with 82 additions and 1333 deletions
@@ -23,8 +23,8 @@
* in: query
* description: |-
* Comma-separated fields that should be included in the returned data.
* * if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
* * without prefix it will replace the entire default fields.
* if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields.
* without prefix it will replace the entire default fields.
* required: false
* schema:
* type: string
@@ -180,6 +180,7 @@
* security:
* - cookie_auth: []
* - jwt_token: []
* x-workflow: getOrdersListWorkflow
*
*/
@@ -58,6 +58,7 @@
* $ref: "#/components/responses/invalid_request_error"
* "500":
* $ref: "#/components/responses/500_error"
* x-workflow: getOrderDetailWorkflow
*
*/
@@ -30,7 +30,8 @@
* - percentage
* target_type:
* type: string
* description: Which item does the promotion apply to. `items` mean the promotion applies to the cart's items; `shipping_methods` means the promotion applies to the cart's shipping methods; `order` means the promotion applies on the entire order.
* description: Which item does the promotion apply to. `items` mean the promotion applies to the cart's items; `shipping_methods` means the promotion applies to the cart's shipping methods; `order`
* means the promotion applies on the entire order.
* enum:
* - items
* - shipping_methods
@@ -12,6 +12,10 @@
* type: string
* title: internal_note
* description: A note viewed only by admin users.
* unit_price:
* type: number
* title: unit_price
* description: The item's unit price.
*
*/
@@ -14,6 +14,10 @@
* type: string
* title: internal_note
* description: A note viewed only by admin users.
* unit_price:
* type: number
* title: unit_price
* description: The item's unit price.
*
*/
@@ -35,7 +35,7 @@
* type: array
* description: The rule's values.
* example:
* - "cusgroup_123"
* - cusgroup_123
* items:
* $ref: "#/components/schemas/BasePromotionRuleValue"
*
@@ -16,6 +16,9 @@
* type: string
* title: avatar_url
* description: The URL of the user's avatar.
* metadata:
* type: object
* description: The user's metadata, can hold custom key-value pairs.
*
*/
@@ -1,102 +0,0 @@
/**
* @schema BaseCustomerAddress
* type: object
* description: The customer's address.
* x-schemaName: BaseCustomerAddress
* required:
* - id
* - address_name
* - is_default_shipping
* - is_default_billing
* - customer_id
* - company
* - first_name
* - last_name
* - address_1
* - address_2
* - city
* - country_code
* - province
* - postal_code
* - phone
* - metadata
* - created_at
* - updated_at
* properties:
* id:
* type: string
* title: id
* description: The address's ID.
* address_name:
* type: string
* title: address_name
* description: The address's name.
* is_default_shipping:
* type: boolean
* title: is_default_shipping
* description: Whether the address is the default shipping address.
* is_default_billing:
* type: boolean
* title: is_default_billing
* description: Whether the address is the default billing address.
* customer_id:
* type: string
* title: customer_id
* description: The ID of the customer that this address belongs to.
* company:
* type: string
* title: company
* description: The customer's company.
* first_name:
* type: string
* title: first_name
* description: The customer's first name.
* last_name:
* type: string
* title: last_name
* description: The customer's last name.
* address_1:
* type: string
* title: address_1
* description: The address's first line.
* address_2:
* type: string
* title: address_2
* description: The address's second line.
* city:
* type: string
* title: city
* description: The address's city.
* country_code:
* type: string
* title: country_code
* description: The address's country code.
* example: us
* province:
* type: string
* title: province
* description: The address's province.
* postal_code:
* type: string
* title: postal_code
* description: The address's postal code.
* phone:
* type: string
* title: phone
* description: The address's phone.
* metadata:
* type: object
* description: The address's metadata, used to store custom key-value pairs.
* created_at:
* type: string
* format: date-time
* title: created_at
* description: The address's creation date.
* updated_at:
* type: string
* format: date-time
* title: updated_at
* description: The address's update date.
*
*/
@@ -1,89 +0,0 @@
/**
* @schema BaseOrderChangeAction
* type: object
* description: The action's actions.
* x-schemaName: BaseOrderChangeAction
* properties:
* order_change:
* $ref: "#/components/schemas/AdminOrderChange"
* id:
* type: string
* title: id
* description: The action's ID.
* order_change_id:
* type: string
* title: order_change_id
* description: The ID of the order change this action belongs to.
* order_id:
* type: string
* title: order_id
* description: The ID of the associated order.
* reference:
* type: string
* title: reference
* description: The name of the table this action applies on.
* enum:
* - claim
* - exchange
* - return
* - order_shipping_method
* reference_id:
* type: string
* title: reference_id
* description: The ID of the record in the referenced table.
* action:
* type: string
* title: action
* description: The applied action.
* details:
* type: object
* description: The action's details.
* example:
* reference_id: 123
* quantity: 1
* internal_note:
* type: string
* title: internal_note
* description: A note viewed only by admin users.
* created_at:
* type: string
* format: date-time
* title: created_at
* description: The date the order change action was created.
* updated_at:
* type: string
* format: date-time
* title: updated_at
* description: The date the order change action was updated.
* return_id:
* type: string
* title: return_id
* description: The ID of the associated return.
* claim_id:
* type: string
* title: claim_id
* description: The ID of the associated claim.
* exchange_id:
* type: string
* title: exchange_id
* description: The ID of the associated exchange.
* order:
* $ref: "#/components/schemas/BaseOrder"
* required:
* - order_change
* - id
* - order_change_id
* - order_id
* - reference
* - reference_id
* - action
* - details
* - internal_note
* - created_at
* - updated_at
* - return_id
* - claim_id
* - exchange_id
* - order
*
*/
@@ -1,8 +0,0 @@
/**
* @schema BasePromotion
* type: object
* description: The application method's promotion.
* x-schemaName: BasePromotion
*
*/
@@ -1,40 +0,0 @@
/**
* @schema BasePromotionRule
* type: object
* description: The rule's rules.
* x-schemaName: BasePromotionRule
* required:
* - id
* - values
* properties:
* id:
* type: string
* title: id
* description: The rule's ID.
* description:
* type: string
* title: description
* description: The rule's description.
* attribute:
* type: string
* title: attribute
* description: The rule's attribute.
* operator:
* type: string
* description: The rule's operator.
* enum:
* - gt
* - lt
* - eq
* - ne
* - in
* - lte
* - gte
* values:
* type: array
* description: The rule's values.
* items:
* $ref: "#/components/schemas/BasePromotionRuleValue"
*
*/
@@ -1,8 +0,0 @@
/**
* @schema IBigNumber
* type: object
* description: The shipping method's discount tax total.
* x-schemaName: IBigNumber
*
*/
@@ -1,37 +0,0 @@
/**
* @schema StoreRegionCountry
* type: object
* description: The country's details.
* x-schemaName: StoreRegionCountry
* required:
* - id
* properties:
* id:
* type: string
* title: id
* description: The country's ID.
* iso_2:
* type: string
* title: iso_2
* description: The country's ISO 2 code.
* example: us
* iso_3:
* type: string
* title: iso_3
* description: The country's ISO 3 codel.
* example: usa
* num_code:
* type: string
* title: num_code
* description: The country's num code.
* name:
* type: string
* title: name
* description: The country's name.
* display_name:
* type: string
* title: display_name
* description: The country's display name.
*
*/