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

docs: generate API reference for 2.12.3 (#14341)

Browse Source
This commit is contained in:
Shahed Nasser
2025-12-17 18:19:46 +02:00
committed by GitHub
parent c0ec54fc15
commit 52e965f411
134 changed files with 7706 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
www/apps/api-reference/specs/store/code_samples/JavaScript/store_locales/get.js
+18
View File
@@ -0,0 +1,18 @@
import Medusa from "@medusajs/js-sdk"
let MEDUSA_BACKEND_URL = "http://localhost:9000"
if (process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL) {
MEDUSA_BACKEND_URL = process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL
}
export const sdk = new Medusa({
baseUrl: MEDUSA_BACKEND_URL,
debug: process.env.NODE_ENV === "development",
publishableKey: process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY,
})
sdk.store.locale.list()
.then(({ locales }) => {
console.log(locales)
})
www/apps/api-reference/specs/store/code_samples/Shell/store_locales/get.sh
+2
View File
@@ -0,0 +1,2 @@
curl '{backend_url}/store/locales' \
-H 'x-publishable-api-key: {your_publishable_api_key}'
www/apps/api-reference/specs/store/components/schemas/AdminCollection.yaml
+5
View File
@@ -48,3 +48,8 @@ properties:
externalDocs:
url: https://docs.medusajs.com/api/admin#manage-metadata
description: Learn how to manage metadata
translations:
type: array
description: The collection's translations.
items:
$ref: ./AdminTranslation.yaml
www/apps/api-reference/specs/store/components/schemas/AdminExportOrderResponse.yaml
+13
View File
@@ -0,0 +1,13 @@
type: object
description: The details of the order export.
x-schemaName: AdminExportOrderResponse
required:
- transaction_id
properties:
transaction_id:
type: string
title: transaction_id
description: >-
The ID of the workflow execution's transaction. Use it to check the status
of the export by sending a GET request to
`/admin/workflows-executions/export-orders/:transaction-id`
www/apps/api-reference/specs/store/components/schemas/AdminLocale.yaml
+34
View File
@@ -0,0 +1,34 @@
type: object
description: The locale's details.
x-schemaName: AdminLocale
required:
- code
- name
- created_at
- updated_at
- deleted_at
properties:
code:
type: string
title: code
description: The locale's code in BCP 47 format.
example: fr-FR
name:
type: string
title: name
description: The locale's display name.
created_at:
type: string
format: date-time
title: created_at
description: The date and time at which the locale was created.
updated_at:
type: string
format: date-time
title: updated_at
description: The date and time at which the locale was last updated.
deleted_at:
type: string
format: date-time
title: deleted_at
description: The date and time at which the locale was deleted.
www/apps/api-reference/specs/store/components/schemas/AdminLocaleListResponse.yaml
+33
View File
@@ -0,0 +1,33 @@
type: object
description: The list of locales with pagination details.
x-schemaName: AdminLocaleListResponse
required:
- limit
- offset
- count
- locales
properties:
limit:
type: number
title: limit
description: The maximum number of locales returned.
offset:
type: number
title: offset
description: The number of locales skipped before retrieving the returned locales.
count:
type: number
title: count
description: The total number of locales matching the query.
estimate_count:
type: number
title: estimate_count
description: >-
The estimated count retrieved from the PostgreSQL query planner, which may
be inaccurate.
x-featureFlag: index_engine
locales:
type: array
description: The list of locales.
items:
$ref: ./AdminLocale.yaml
www/apps/api-reference/specs/store/components/schemas/AdminLocaleResponse.yaml
+8
View File
@@ -0,0 +1,8 @@
type: object
description: The locale's details.
x-schemaName: AdminLocaleResponse
required:
- locale
properties:
locale:
$ref: ./AdminLocale.yaml
www/apps/api-reference/specs/store/components/schemas/AdminPriceListPriceListResponse.yaml
+33
View File
@@ -0,0 +1,33 @@
type: object
description: The list of prices.
x-schemaName: AdminPriceListPriceListResponse
required:
- limit
- offset
- count
- prices
properties:
limit:
type: number
title: limit
description: The maximum number of prices returned.
offset:
type: number
title: offset
description: The number of items skipped before retrieving the prices.
count:
type: number
title: count
description: The total number of prices.
estimate_count:
type: number
title: estimate_count
description: >-
The estimated count retrieved from the PostgreSQL query planner, which may
be inaccurate.
x-featureFlag: index_engine
prices:
type: array
description: The list of prices.
items:
$ref: ./AdminPrice.yaml
www/apps/api-reference/specs/store/components/schemas/AdminProduct.yaml
+5
View File
@@ -171,3 +171,8 @@ properties:
description: The date the product was deleted.
shipping_profile:
$ref: ./AdminShippingProfile.yaml
translations:
type: array
description: The product's translations.
items:
$ref: ./AdminTranslation.yaml
www/apps/api-reference/specs/store/components/schemas/AdminProductTag.yaml
+5
View File
@@ -36,3 +36,8 @@ properties:
externalDocs:
url: https://docs.medusajs.com/api/admin#manage-metadata
description: Learn how to manage metadata
translations:
type: array
description: The tag's translations.
items:
$ref: ./AdminTranslation.yaml
www/apps/api-reference/specs/store/components/schemas/AdminProductType.yaml
+5
View File
@@ -36,3 +36,8 @@ properties:
externalDocs:
url: https://docs.medusajs.com/api/admin#manage-metadata
description: Learn how to manage metadata
translations:
type: array
description: The type's translations.
items:
$ref: ./AdminTranslation.yaml
www/apps/api-reference/specs/store/components/schemas/AdminProductVariant.yaml
+5
View File
@@ -155,3 +155,8 @@ properties:
type: string
title: thumbnail
description: The variant's thumbnail.
translations:
type: array
description: The variant's translations.
items:
$ref: ./AdminTranslation.yaml
www/apps/api-reference/specs/store/components/schemas/AdminStore.yaml
+6
View File
@@ -5,6 +5,7 @@ required:
- id
- name
- supported_currencies
- supported_locales
- default_sales_channel_id
- default_region_id
- default_location_id
@@ -53,3 +54,8 @@ properties:
format: date-time
title: updated_at
description: The date the store was updated.
supported_locales:
type: array
description: The store's supported locales.
items:
$ref: ./AdminStoreLocale.yaml
www/apps/api-reference/specs/store/components/schemas/AdminStoreLocale.yaml
+41
View File
@@ -0,0 +1,41 @@
type: object
description: The details of a store's locale.
x-schemaName: AdminStoreLocale
required:
- id
- locale_code
- store_id
- locale
- created_at
- updated_at
- deleted_at
properties:
id:
type: string
title: id
description: The locale's ID.
locale_code:
type: string
title: locale_code
description: The locale's code in BCP 47 format.
store_id:
type: string
title: store_id
description: The ID of the store to which the locale belongs.
locale:
$ref: ./AdminLocale.yaml
created_at:
type: string
format: date-time
title: created_at
description: The date the locale was created.
updated_at:
type: string
format: date-time
title: updated_at
description: The date the locale was updated.
deleted_at:
type: string
format: date-time
title: deleted_at
description: The date the locale was deleted.
www/apps/api-reference/specs/store/components/schemas/AdminTranslation.yaml
+57
View File
@@ -0,0 +1,57 @@
type: object
description: The translation's details.
x-schemaName: AdminTranslation
required:
- id
- reference_id
- reference
- locale_code
- translations
- created_at
- updated_at
- deleted_at
properties:
id:
type: string
title: id
description: The translation's ID.
reference_id:
type: string
title: reference_id
description: >-
The ID of the resource that the translation belongs to. For example, the
ID of a product.
example: prod_123
reference:
type: string
title: reference
description: The resource that the translation belongs to.
example: product
locale_code:
type: string
title: locale_code
description: The translation's locale code in BCP 47 format.
example: fr-FR
translations:
type: object
description: >-
The translation key-value pairs. Each key is a field in the resource, and
the value is the translated text.
example:
title: Chaussures
description: Des chaussures élégantes.
created_at:
type: string
format: date-time
title: created_at
description: The date that the translation was created.
updated_at:
type: string
format: date-time
title: updated_at
description: The date that the translation was updated.
deleted_at:
type: string
format: date-time
title: deleted_at
description: The date that the translation was deleted.
www/apps/api-reference/specs/store/components/schemas/AdminTranslationSettingsResponse.yaml
+16
View File
@@ -0,0 +1,16 @@
type: object
description: The translation settings' details.
x-schemaName: AdminTranslationSettingsResponse
required:
- translatable_fields
properties:
translatable_fields:
type: object
description: >-
Key-value pairs of translatable fields for different entities. Each key is
an entity type, and the value is an array of fields that can be translated
for that entity.
example:
product:
- title
- description
www/apps/api-reference/specs/store/components/schemas/AdminTranslationStatisticsResponse.yaml
+74
View File
@@ -0,0 +1,74 @@
type: object
description: The translation statistics details.
x-schemaName: AdminTranslationStatisticsResponse
required:
- statistics
properties:
statistics:
type: object
description: >-
The translation statistics for different entity types. The key is the
entity type, and the value is an object containing the statistics for that
entity type.
example:
product:
expected: 150
translated: 120
missing: 30
by_locale:
fr-FR:
expected: 150
translated: 120
missing: 30
required:
- by_locale
- expected
- translated
- missing
additionalProperties:
type: object
properties:
by_locale:
type: object
description: >-
The translation statistics of an entity type broken down by locale.
The key is the locale code in BCP 47 format, and the value is an
object containing the statistics for that locale.
example:
fr-FR:
expected: 150
translated: 120
missing: 30
required:
- expected
- translated
- missing
additionalProperties:
type: object
properties:
expected:
type: number
title: expected
description: The total number of translatable fields.
translated:
type: number
title: translated
description: The number of translated fields.
missing:
type: number
title: missing
description: The number of fields that are yet to be translated.
expected:
type: number
title: expected
description: The total number of translatable fields across specified locales.
translated:
type: number
title: translated
description: The number of translated fields across specified locales.
missing:
type: number
title: missing
description: >-
The number of fields that are yet to be translated across specified
locales.
www/apps/api-reference/specs/store/components/schemas/AdminTranslationsBatchResponse.yaml
+42
View File
@@ -0,0 +1,42 @@
type: object
description: The batch response for managing translations.
x-schemaName: AdminTranslationsBatchResponse
required:
- created
- updated
- deleted
properties:
created:
type: array
description: The created translations.
items:
$ref: ./AdminTranslation.yaml
updated:
type: array
description: The updated translations.
items:
$ref: ./AdminTranslation.yaml
deleted:
type: object
description: Summary of the deleted translations.
required:
- ids
- object
- deleted
properties:
ids:
type: array
description: The IDs of the deleted translations.
items:
type: string
title: ids
description: A translation ID.
object:
type: string
title: object
description: The type of object deleted.
default: translation
deleted:
type: boolean
title: deleted
description: Whether the translations were successfully deleted.
www/apps/api-reference/specs/store/components/schemas/AdminUpdateOrder.yaml
+8
View File
@@ -17,3 +17,11 @@ properties:
externalDocs:
url: https://docs.medusajs.com/api/admin#manage-metadata
description: Learn how to manage metadata
locale:
type: string
title: locale
description: >-
The order's locale in [BCP
47](https://gist.github.com/typpo/b2b828a35e683b9bf8db91b5404f1bd1)
format.
example: en-US
www/apps/api-reference/specs/store/components/schemas/AdminUpdateStore.yaml
+5
View File
@@ -29,3 +29,8 @@ properties:
externalDocs:
url: https://docs.medusajs.com/api/admin#manage-metadata
description: Learn how to manage metadata
supported_locales:
type: array
description: The store's supported locales.
items:
$ref: ./AdminUpdateStoreSupportedLocale.yaml
www/apps/api-reference/specs/store/components/schemas/AdminUpdateStoreSupportedLocale.yaml
+13
View File
@@ -0,0 +1,13 @@
type: object
description: The payload to update a store's supported locale.
x-schemaName: AdminUpdateStoreSupportedLocale
required:
- locale_code
properties:
locale_code:
type: string
title: locale_code
description: >-
The locale's code in [BCP 47
format](https://gist.github.com/typpo/b2b828a35e683b9bf8db91b5404f1bd1).
example: fr-FR
www/apps/api-reference/specs/store/components/schemas/Order.yaml
+8
View File
@@ -328,3 +328,11 @@ properties:
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/order/custom-display-id
locale:
type: string
title: locale
description: >-
The order's locale in [BCP
47](https://gist.github.com/typpo/b2b828a35e683b9bf8db91b5404f1bd1)
format.
example: en-US
www/apps/api-reference/specs/store/components/schemas/StoreLocale.yaml
+19
View File
@@ -0,0 +1,19 @@
type: object
description: The store locale's details.
x-schemaName: StoreLocale
required:
- code
- name
properties:
code:
type: string
title: code
description: >-
The locale's code in [BCP 47
format](https://gist.github.com/typpo/b2b828a35e683b9bf8db91b5404f1bd1).
example: en-US
name:
type: string
title: name
description: The locale's display name.
example: English (United States)
www/apps/api-reference/specs/store/components/schemas/StoreLocaleListResponse.yaml
+11
View File
@@ -0,0 +1,11 @@
type: object
description: The list of supported locales in the store.
x-schemaName: StoreLocaleListResponse
required:
- locales
properties:
locales:
type: array
description: The list of supported locales in the store.
items:
$ref: ./StoreLocale.yaml
www/apps/api-reference/specs/store/openapi.full.yaml
+1496 -2
View File
File diff suppressed because it is too large Load Diff
www/apps/api-reference/specs/store/openapi.yaml
+15
View File
@@ -92,6 +92,19 @@ tags:
</Note>
x-associatedSchema:
$ref: ./components/schemas/StoreGiftCard.yaml
- name: Locales
description: >
A locale is a language that content is translated into for customers to
view in a storefront.
Medusa installs locales by default. These API routes allow you to retrieve
supported locales in the store.
externalDocs:
description: Learn more about locales and translations.
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/concepts
x-associatedSchema:
$ref: ./components/schemas/StoreLocale.yaml
- name: Orders
description: |
Guest and registered customers can view orders they placed.
@@ -286,6 +299,8 @@ paths:
$ref: paths/store_gift-cards_{idOrCode}.yaml
/store/gift-cards/{idOrCode}/redeem:
$ref: paths/store_gift-cards_{idOrCode}_redeem.yaml
/store/locales:
$ref: paths/store_locales.yaml
/store/orders:
$ref: paths/store_orders.yaml
/store/orders/{id}:
www/apps/api-reference/specs/store/paths/store_carts.yaml
+22
View File
@@ -12,6 +12,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -30,6 +41,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
requestBody:
content:
application/json:
www/apps/api-reference/specs/store/paths/store_carts_{id}.yaml
+44
View File
@@ -20,6 +20,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -38,6 +49,17 @@ get:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
@@ -94,6 +116,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -112,6 +145,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
requestBody:
content:
application/json:
www/apps/api-reference/specs/store/paths/store_carts_{id}_complete.yaml
+22
View File
@@ -22,6 +22,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -40,6 +51,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
www/apps/api-reference/specs/store/paths/store_carts_{id}_customer.yaml
+22
View File
@@ -26,6 +26,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -46,6 +57,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
security:
- cookie_auth: []
- jwt_token: []
www/apps/api-reference/specs/store/paths/store_carts_{id}_line-items.yaml
+22
View File
@@ -23,6 +23,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -41,6 +52,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
requestBody:
content:
application/json:
www/apps/api-reference/specs/store/paths/store_carts_{id}_line-items_{line_id}.yaml
+44
View File
@@ -29,6 +29,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -47,6 +58,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
requestBody:
content:
application/json:
@@ -147,6 +169,17 @@ delete:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -165,6 +198,17 @@ delete:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
www/apps/api-reference/specs/store/paths/store_carts_{id}_promotions.yaml
+44
View File
@@ -23,6 +23,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -41,6 +52,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
requestBody:
content:
application/json:
@@ -98,6 +120,17 @@ delete:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -116,6 +149,17 @@ delete:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: Shell
label: cURL
www/apps/api-reference/specs/store/paths/store_carts_{id}_shipping-methods.yaml
+22
View File
@@ -25,6 +25,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -43,6 +54,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
requestBody:
content:
application/json:
www/apps/api-reference/specs/store/paths/store_carts_{id}_taxes.yaml
+22
View File
@@ -19,6 +19,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -37,6 +48,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: Shell
label: cURL
www/apps/api-reference/specs/store/paths/store_collections.yaml
+22
View File
@@ -18,6 +18,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -693,6 +704,17 @@ get:
type: string
title: id
description: The collection's ID.
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
www/apps/api-reference/specs/store/paths/store_collections_{id}.yaml
+22
View File
@@ -24,6 +24,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -42,6 +53,17 @@ get:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
www/apps/api-reference/specs/store/paths/store_currencies.yaml
+22
View File
@@ -14,6 +14,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -123,6 +134,17 @@ get:
type: boolean
title: with_deleted
description: Whether to include deleted records in the result.
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: Shell
label: cURL
www/apps/api-reference/specs/store/paths/store_currencies_{code}.yaml
+22
View File
@@ -20,6 +20,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -38,6 +49,17 @@ get:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: Shell
label: cURL
www/apps/api-reference/specs/store/paths/store_customers.yaml
+22
View File
@@ -19,6 +19,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -41,6 +52,17 @@ post:
documentation.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
requestBody:
content:
application/json:
www/apps/api-reference/specs/store/paths/store_customers_me.yaml
+44
View File
@@ -19,6 +19,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -45,6 +56,17 @@ get:
documentation.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
security:
- cookie_auth: []
- jwt_token: []
@@ -96,6 +118,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -118,6 +151,17 @@ post:
documentation.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
security:
- cookie_auth: []
- jwt_token: []
www/apps/api-reference/specs/store/paths/store_customers_me_addresses.yaml
+44
View File
@@ -20,6 +20,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: city
in: query
description: Filter by the address's city.
@@ -129,6 +140,17 @@ get:
items:
type: object
title: $or
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
security:
- cookie_auth: []
- jwt_token: []
@@ -181,6 +203,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -207,6 +240,17 @@ post:
documentation.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
security:
- cookie_auth: []
- jwt_token: []
www/apps/api-reference/specs/store/paths/store_customers_me_addresses_{address_id}.yaml
+66
View File
@@ -21,6 +21,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -47,6 +58,17 @@ get:
documentation.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
security:
- cookie_auth: []
- jwt_token: []
@@ -106,6 +128,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -132,6 +165,17 @@ post:
documentation.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
security:
- cookie_auth: []
- jwt_token: []
@@ -199,6 +243,17 @@ delete:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -225,6 +280,17 @@ delete:
documentation.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
security:
- cookie_auth: []
- jwt_token: []
www/apps/api-reference/specs/store/paths/store_locales.yaml
+73
View File
@@ -0,0 +1,73 @@
get:
operationId: GetLocales
summary: List Locales
description: >-
Retrieve the list of supported locales. You can use this list to allow
customers to select their preferred locale in your storefront.
externalDocs:
url: https://docs.medusajs.com/resources/storefront-development/localization
description: Learn how to serve localized content in your storefront.
x-authenticated: false
parameters:
- name: x-publishable-api-key
in: header
description: Publishable API Key created in the Medusa Admin.
required: true
schema:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
source:
$ref: ../code_samples/JavaScript/store_locales/get.js
- lang: Shell
label: cURL
source:
$ref: ../code_samples/Shell/store_locales/get.sh
tags:
- Locales
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: ../components/schemas/StoreLocaleListResponse.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
x-since: 2.12.3
x-featureFlag: translation
www/apps/api-reference/specs/store/paths/store_orders.yaml
+22
View File
@@ -15,6 +15,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -141,6 +152,17 @@ get:
type: boolean
title: with_deleted
description: Whether to include deleted records in the result.
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
www/apps/api-reference/specs/store/paths/store_orders_{id}.yaml
+22
View File
@@ -20,6 +20,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -38,6 +49,17 @@ get:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
www/apps/api-reference/specs/store/paths/store_orders_{id}_transfer_accept.yaml
+22
View File
@@ -26,6 +26,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -46,6 +57,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
requestBody:
content:
application/json:
www/apps/api-reference/specs/store/paths/store_orders_{id}_transfer_cancel.yaml
+22
View File
@@ -23,6 +23,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -43,6 +54,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
www/apps/api-reference/specs/store/paths/store_orders_{id}_transfer_decline.yaml
+22
View File
@@ -22,6 +22,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -42,6 +53,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
requestBody:
content:
application/json:
www/apps/api-reference/specs/store/paths/store_orders_{id}_transfer_request.yaml
+22
View File
@@ -23,6 +23,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -43,6 +54,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
requestBody:
content:
application/json:
www/apps/api-reference/specs/store/paths/store_payment-collections.yaml
+22
View File
@@ -18,6 +18,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -36,6 +47,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
requestBody:
content:
application/json:
www/apps/api-reference/specs/store/paths/store_payment-collections_{id}_payment-sessions.yaml
+22
View File
@@ -43,6 +43,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -61,6 +72,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
requestBody:
content:
application/json:
www/apps/api-reference/specs/store/paths/store_payment-providers.yaml
+22
View File
@@ -18,6 +18,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -87,6 +98,17 @@ get:
type: boolean
title: with_deleted
description: Whether to include deleted records in the result.
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
www/apps/api-reference/specs/store/paths/store_product-categories.yaml
+22
View File
@@ -19,6 +19,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -760,6 +771,17 @@ get:
type: boolean
title: with_deleted
description: Whether to include deleted records in the result.
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
www/apps/api-reference/specs/store/paths/store_product-categories_{id}.yaml
+22
View File
@@ -24,6 +24,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -82,6 +93,17 @@ get:
`*category_children` to retreieve the fields of all child categories,
or select specific fields to make the response size smaller. For
example, `fields=category_children.id,category_children.name`.
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
www/apps/api-reference/specs/store/paths/store_product-tags.yaml
+22
View File
@@ -14,6 +14,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -679,6 +690,17 @@ get:
type: boolean
title: with_deleted
description: Whether to include deleted records in the result.
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: Shell
label: cURL
www/apps/api-reference/specs/store/paths/store_product-tags_{id}.yaml
+22
View File
@@ -20,6 +20,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -40,6 +51,17 @@ get:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: Shell
label: cURL
www/apps/api-reference/specs/store/paths/store_product-types.yaml
+22
View File
@@ -14,6 +14,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: |-
@@ -676,6 +687,17 @@ get:
type: boolean
title: with_deleted
description: Whether to include deleted records in the result.
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: Shell
label: cURL
www/apps/api-reference/specs/store/paths/store_product-types_{id}.yaml
+22
View File
@@ -20,6 +20,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: |-
@@ -37,6 +48,17 @@ get:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: Shell
label: cURL
www/apps/api-reference/specs/store/paths/store_products.yaml
+36 -1
View File
@@ -1,9 +1,22 @@
get:
operationId: GetProducts
summary: List Products
description: >-
description: >
Retrieve a list of products. The products can be filtered by fields such as
`id`. The products can also be sorted or paginated.
You can retrieve the content of the products translated to a specific locale
either by passing the `locale` query parameter or by setting the
`Content-Language` header to the desired locale code in BCP 47 format. If
you don't pass a locale, and your store has a default locale, the default
locale will be used.
With localization, the products' content like title and description will be
in the specified locale if a translation is available, and fallback to the
original content otherwise. Learn more in the [Localization](#localization)
section.
x-authenticated: false
externalDocs:
url: https://docs.medusajs.com/resources/storefront-development/products/price
@@ -17,6 +30,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -840,6 +864,17 @@ get:
type: string
title: cart_id
description: The product's cart id.
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
www/apps/api-reference/specs/store/paths/store_products_{id}.yaml
+36 -1
View File
@@ -1,9 +1,22 @@
get:
operationId: GetProductsId
summary: Get a Product
description: >-
description: >
Retrieve a product by its ID. You can expand the product's relations or
select the fields that should be returned.
You can retrieve the content of the product translated to a specific locale
either by passing the `locale` query parameter or by setting the
`Content-Language` header to the desired locale code in BCP 47 format. If
you don't pass a locale, and your store has a default locale, the default
locale will be used.
With localization, the product's content like title and description will be
in the specified locale if a translation is available, and fallback to the
original content otherwise. Learn more in the [Localization](#localization)
section.
x-authenticated: false
externalDocs:
url: https://docs.medusajs.com/resources/storefront-development/products/price
@@ -23,6 +36,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -101,6 +125,17 @@ get:
The ID of the customer's cart. If set, the cart's region and shipping
address's country code and province are used instead of the
`region_id`, `country_code`, and `province` properties.
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
www/apps/api-reference/specs/store/paths/store_regions.yaml
+22
View File
@@ -17,6 +17,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -156,6 +167,17 @@ get:
type: boolean
title: with_deleted
description: Whether to include deleted records in the result.
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
www/apps/api-reference/specs/store/paths/store_regions_{id}.yaml
+22
View File
@@ -20,6 +20,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -38,6 +49,17 @@ get:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
www/apps/api-reference/specs/store/paths/store_return-reasons.yaml
+22
View File
@@ -14,6 +14,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -73,6 +84,17 @@ get:
type: boolean
title: with_deleted
description: Whether to include deleted records in the result.
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: Shell
label: cURL
www/apps/api-reference/specs/store/paths/store_return-reasons_{id}.yaml
+22
View File
@@ -20,6 +20,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -38,6 +49,17 @@ get:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: Shell
label: cURL
www/apps/api-reference/specs/store/paths/store_returns.yaml
+22
View File
@@ -14,6 +14,28 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
requestBody:
content:
application/json:
www/apps/api-reference/specs/store/paths/store_shipping-options.yaml
+22
View File
@@ -21,6 +21,17 @@ get:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -116,6 +127,17 @@ get:
type: boolean
title: is_return
description: Whether the shipping option can be used for returns.
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
x-codeSamples:
- lang: JavaScript
label: JS SDK
www/apps/api-reference/specs/store/paths/store_shipping-options_{id}_calculate.yaml
+22
View File
@@ -18,6 +18,17 @@ post:
type: string
externalDocs:
url: https://docs.medusajs.com/api/store#publishable-api-key
- name: Content-Language
in: header
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
- name: fields
in: query
description: >-
@@ -38,6 +49,17 @@ post:
prefix it will replace the entire default fields.
externalDocs:
url: '#select-fields-and-relations'
- name: locale
in: query
description: The locale in BCP 47 format to retrieve localized content.
required: false
schema:
type: string
example: en-US
externalDocs:
url: >-
https://docs.medusajs.com/resources/commerce-modules/translation/storefront
description: Learn more in the Serve Translations in Storefront guide.
requestBody:
content:
application/json: