Skip to content

Commit

Permalink
chore(docs): Updated API Reference (automated) (medusajs#10685)
Browse files Browse the repository at this point in the history
Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action

Co-authored-by: Oli Juhl <[email protected]>
Co-authored-by: Shahed Nasser <[email protected]>
  • Loading branch information
3 people authored Dec 23, 2024
1 parent 326f190 commit 198fa53
Show file tree
Hide file tree
Showing 19 changed files with 621 additions and 0 deletions.
2 changes: 2 additions & 0 deletions packages/cli/oas/medusa-oas-cli/redocly/redocly-config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -137,6 +137,8 @@ decorators:
- AdminProduct
Return:
- OrderExchange
OrderCreditLine:
- Order
theme:
openapi:
theme:
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
curl '{backend_url}/admin/fulfillment-providers/{id}/options' \
-H 'Authorization: Bearer {access_token}'
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
type: object
description: The fulfillment option's details.
x-schemaName: AdminFulfillmentProviderOption
required:
- id
- is_return
properties:
id:
type: string
title: id
description: The fulfillment option's ID.
is_return:
type: boolean
title: is_return
description: Whether the fulfillment option is used for returns.
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
type: object
description: The paginated list of fulfillment options.
x-schemaName: AdminFulfillmentProviderOptionsListResponse
required:
- limit
- offset
- count
- fulfillment_options
properties:
limit:
type: number
title: limit
description: The maximum number of items returned.
offset:
type: number
title: offset
description: The number of items skipped before retrieving the returned items.
count:
type: number
title: count
description: The total number of items.
fulfillment_options:
type: array
description: The list of fulfillment options.
items:
$ref: ./AdminFulfillmentProviderOption.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -211,3 +211,10 @@ properties:
type: number
title: display_id
description: The order's display ID.
credit_lines:
type: array
description: >-
The order's credit lines, useful to add additional payment amounts for an
order.
items:
$ref: ./OrderCreditLine.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
type: object
description: The credit line's details.
x-schemaName: OrderCreditLine
required:
- id
- order_id
- order
- reference
- reference_id
- metadata
- created_at
- updated_at
properties:
id:
type: string
title: id
description: The credit line's ID.
order_id:
type: string
title: order_id
description: The ID of the associated order.
order:
type: object
reference:
type: string
title: reference
description: >-
The table that this credit line references. For example,
`payment_collection`.
reference_id:
type: string
title: reference_id
description: The ID of the record in the referenced table. For example, `paycol_123`.
metadata:
type: object
description: The credit line's metadata, can hold custom key-value pairs.
created_at:
type: string
format: date-time
title: created_at
description: The date the credit line was created.
updated_at:
type: string
format: date-time
title: updated_at
description: The date the credit line was updated.
137 changes: 137 additions & 0 deletions www/apps/api-reference/specs/admin/openapi.full.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -15374,6 +15374,50 @@ paths:
$ref: '#/components/responses/invalid_request_error'
'500':
$ref: '#/components/responses/500_error'
/admin/fulfillment-providers/{id}/options:
get:
operationId: GetFulfillmentProvidersIdOptions
summary: List Fulfillment Options
description: Retrieve the list of fulfillment options of a fulfillment provider. These options may be retrieved from an integrated third-party service.
x-authenticated: true
parameters:
- name: id
in: path
description: The fulfillment provider's ID.
required: true
schema:
type: string
security:
- api_token: []
- cookie_auth: []
- jwt_token: []
x-codeSamples:
- lang: Shell
label: cURL
source: |-
curl '{backend_url}/admin/fulfillment-providers/{id}/options' \
-H 'Authorization: Bearer {access_token}'
tags:
- Fulfillment Providers
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/AdminFulfillmentProviderOptionsListResponse'
'400':
$ref: '#/components/responses/400_error'
'401':
$ref: '#/components/responses/unauthorized'
'404':
$ref: '#/components/responses/not_found_error'
'409':
$ref: '#/components/responses/invalid_state_error'
'422':
$ref: '#/components/responses/invalid_request_error'
'500':
$ref: '#/components/responses/500_error'
/admin/fulfillment-sets/{id}:
delete:
operationId: DeleteFulfillmentSetsId
Expand Down Expand Up @@ -47310,6 +47354,49 @@ components:
description: The list of fulfillment providers.
items:
$ref: '#/components/schemas/AdminFulfillmentProvider'
AdminFulfillmentProviderOption:
type: object
description: The fulfillment option's details.
x-schemaName: AdminFulfillmentProviderOption
required:
- id
- is_return
properties:
id:
type: string
title: id
description: The fulfillment option's ID.
is_return:
type: boolean
title: is_return
description: Whether the fulfillment option is used for returns.
AdminFulfillmentProviderOptionsListResponse:
type: object
description: The paginated list of fulfillment options.
x-schemaName: AdminFulfillmentProviderOptionsListResponse
required:
- limit
- offset
- count
- fulfillment_options
properties:
limit:
type: number
title: limit
description: The maximum number of items returned.
offset:
type: number
title: offset
description: The number of items skipped before retrieving the returned items.
count:
type: number
title: count
description: The total number of items.
fulfillment_options:
type: array
description: The list of fulfillment options.
items:
$ref: '#/components/schemas/AdminFulfillmentProviderOption'
AdminFulfillmentResponse:
type: object
description: A fulfillment's details.
Expand Down Expand Up @@ -58909,6 +58996,11 @@ components:
type: number
title: display_id
description: The order's display ID.
credit_lines:
type: array
description: The order's credit lines, useful to add additional payment amounts for an order.
items:
$ref: '#/components/schemas/OrderCreditLine'
OrderAddress:
type: object
description: The address's details.
Expand Down Expand Up @@ -59334,6 +59426,51 @@ components:
title: canceled_at
description: The date the claim was canceled.
format: date-time
OrderCreditLine:
type: object
description: The credit line's details.
x-schemaName: OrderCreditLine
required:
- id
- order_id
- order
- reference
- reference_id
- metadata
- created_at
- updated_at
properties:
id:
type: string
title: id
description: The credit line's ID.
order_id:
type: string
title: order_id
description: The ID of the associated order.
order:
type: object
reference:
type: string
title: reference
description: The table that this credit line references. For example, `payment_collection`.
reference_id:
type: string
title: reference_id
description: The ID of the record in the referenced table. For example, `paycol_123`.
metadata:
type: object
description: The credit line's metadata, can hold custom key-value pairs.
created_at:
type: string
format: date-time
title: created_at
description: The date the credit line was created.
updated_at:
type: string
format: date-time
title: updated_at
description: The date the credit line was updated.
OrderExchange:
type: object
description: The order change's exchange.
Expand Down
2 changes: 2 additions & 0 deletions www/apps/api-reference/specs/admin/openapi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -725,6 +725,8 @@ paths:
$ref: paths/admin_exchanges_{id}_request.yaml
/admin/fulfillment-providers:
$ref: paths/admin_fulfillment-providers.yaml
/admin/fulfillment-providers/{id}/options:
$ref: paths/admin_fulfillment-providers_{id}_options.yaml
/admin/fulfillment-sets/{id}:
$ref: paths/admin_fulfillment-sets_{id}.yaml
/admin/fulfillment-sets/{id}/service-zones:
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
get:
operationId: GetFulfillmentProvidersIdOptions
summary: List Fulfillment Options
description: >-
Retrieve the list of fulfillment options of a fulfillment provider. These
options may be retrieved from an integrated third-party service.
x-authenticated: true
parameters:
- name: id
in: path
description: The fulfillment provider's ID.
required: true
schema:
type: string
security:
- api_token: []
- cookie_auth: []
- jwt_token: []
x-codeSamples:
- lang: Shell
label: cURL
source:
$ref: ../code_samples/Shell/admin_fulfillment-providers_{id}_options/get.sh
tags:
- Fulfillment Providers
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: >-
../components/schemas/AdminFulfillmentProviderOptionsListResponse.yaml
'400':
$ref: ../components/responses/400_error.yaml
'401':
$ref: ../components/responses/unauthorized.yaml
'404':
$ref: ../components/responses/not_found_error.yaml
'409':
$ref: ../components/responses/invalid_state_error.yaml
'422':
$ref: ../components/responses/invalid_request_error.yaml
'500':
$ref: ../components/responses/500_error.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
type: object
description: The fulfillment option's details.
x-schemaName: AdminFulfillmentProviderOption
required:
- id
- is_return
properties:
id:
type: string
title: id
description: The fulfillment option's ID.
is_return:
type: boolean
title: is_return
description: Whether the fulfillment option is used for returns.
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
type: object
description: The paginated list of fulfillment options.
x-schemaName: AdminFulfillmentProviderOptionsListResponse
required:
- limit
- offset
- count
- fulfillment_options
properties:
limit:
type: number
title: limit
description: The maximum number of items returned.
offset:
type: number
title: offset
description: The number of items skipped before retrieving the returned items.
count:
type: number
title: count
description: The total number of items.
fulfillment_options:
type: array
description: The list of fulfillment options.
items:
$ref: ./AdminFulfillmentProviderOption.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -211,3 +211,10 @@ properties:
type: number
title: display_id
description: The order's display ID.
credit_lines:
type: array
description: >-
The order's credit lines, useful to add additional payment amounts for an
order.
items:
$ref: ./OrderCreditLine.yaml
Loading

0 comments on commit 198fa53

Please sign in to comment.