From 21b1ae53e490085058fd896d6a91a5499f48863c Mon Sep 17 00:00:00 2001 From: Shahed Nasser Date: Tue, 10 Jan 2023 21:09:11 +0200 Subject: [PATCH 1/6] docs: changed links on the homepage (#2981) * docs: changed homepage * added missing import * added related links * added a link to the user guide on homepage --- docs/content/homepage.mdx | 38 +++++++-------- docs/content/introduction.md | 8 ++++ docs/content/usage/create-medusa-app.mdx | 60 +++++++++++++++++------- www/docs/sidebars.js | 30 +++++++----- www/docs/static/img/user-guide-dark.svg | 3 ++ www/docs/static/img/user-guide.svg | 3 ++ 6 files changed, 96 insertions(+), 46 deletions(-) create mode 100644 www/docs/static/img/user-guide-dark.svg create mode 100644 www/docs/static/img/user-guide.svg diff --git a/docs/content/homepage.mdx b/docs/content/homepage.mdx index c66f233f9e..ee030460b4 100644 --- a/docs/content/homepage.mdx +++ b/docs/content/homepage.mdx @@ -20,7 +20,7 @@ Learn about Medusa basic features and kickstart your ecommerce project. diff --git a/docs/content/introduction.md b/docs/content/introduction.md index 0f9993c4c2..41783cfde4 100644 --- a/docs/content/introduction.md +++ b/docs/content/introduction.md @@ -39,3 +39,11 @@ Your customers use the Storefront to view products and make orders. Medusa provi - [Bulk Import](./user-guide/products/import.mdx): Bulk import strategies for different entities including [products](./advanced/admin/import-products.mdx) and [price lists](./advanced/admin/import-prices.mdx). - [Bulk Export](./user-guide/products/export.mdx): Bulk export strategies for different entities including [products](./user-guide/products/export.mdx) and [orders](./user-guide/orders/export.mdx). - Complete Customization Capabilities: Aside from all the features that Medusa provides, it is completely customizable providing capabilities to create custom [endpoints](./advanced/backend/endpoints/add.md), [services](./advanced/backend/services/create-service.md), [subscribers](./advanced/backend/subscribers/create-subscriber.md), [batch job strategies](./advanced/backend/batch-jobs/create.md), and much more! + +--- + +## See Also + +- [Quickstart guide](./quickstart/quick-start.mdx) +- [Install the Next.js Storefront](./starters/nextjs-medusa-starter.mdx) +- [Install Medusa Admin](./admin/quickstart.mdx) \ No newline at end of file diff --git a/docs/content/usage/create-medusa-app.mdx b/docs/content/usage/create-medusa-app.mdx index 60aa0354d1..f8accfa959 100644 --- a/docs/content/usage/create-medusa-app.mdx +++ b/docs/content/usage/create-medusa-app.mdx @@ -1,24 +1,51 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; +import Feedback from '@site/src/components/Feedback'; -# Use create-medusa-app +# Install Medusa with create-medusa-app In this document, you’ll learn how to use `create-medusa-app` to create a Medusa project with the three main components of Medusa. ## Overview -As explained in the [Introduction guide](../introduction.md), Medusa is composed of three different components: the headless server, the storefront, and the admin dashboard. +Medusa is composed of three different components: the headless server, the storefront, and the admin dashboard. Medusa provides the necessary tools and resources to set up the three components separately. This ensures that developers have full freedom to choose their tech stack, as they can choose any framework for the storefront and admin dashboard. -However, if you’re interested in using Medusa’s starters for the three components, you can easily make use of the `create-medusa-app` command instead of creating each separately. +However, if you’re interested in using Medusa’s starters for the three components, you can make use of the `create-medusa-app` command instead of creating each separately. When you run the `create-medusa-app` command, you’ll install a Medusa server, a Medusa admin, and optionally a storefront at the same time. +:::note + +If you instead want to quickly install and setup only a Medusa server, follow [this quickstart guide](../quickstart/quick-start.mdx). + +::: + +--- + +## Prerequisites + +### Node.js + +Medusa supports Node versions 14 and 16. You can check which version of Node you have by running the following command: + +```bash noReport +node -v +``` + +You can install Node from the [official website](https://nodejs.org/en/). + +### Git + +Git is required for this setup. You can find instructions on how to install it from the [Set up your dev environment documentation](../tutorial/0-set-up-your-development-environment.mdx#git). + --- ## How to Create a Medusa Project +A Medusa project is composed of the server, storefront, and admin. + In your terminal, run the following command: @@ -44,9 +71,9 @@ You’ll then be asked to enter the name of the directory you want the project t ### Choose Medusa Server Starter -Next, you’ll be asked to choose the Medusa starter. The Medusa Server is created from a starter template. By default, it is created from the `medusa-starter-default` template. +Next, you’ll be asked to choose the Medusa server starter. The Medusa Server is created from a starter template. By default, it is created from the `medusa-starter-default` template. -You can either pick the default Medusa starter, the Contentful starter or enter a starter URL by choosing `Other`: +You can either pick the default Medusa server starter, the Contentful starter or enter a starter URL by choosing `Other`: ```bash noReport ? Which Medusa starter would you like to install? … @@ -57,12 +84,6 @@ You can either pick the default Medusa starter, the Contentful starter or enter The server will be installed under the `backend` directory under the project directory. An SQLite database will be created inside that directory as well with demo data seeded into it. -:::tip - -You can learn more about the Contentful starter in the [Contentful Integration documentation](../add-plugins/contentful/index.md). - -::: - ### Choose Storefront Starter After choosing the Medusa starter, you’ll be asked to choose the storefront starter. You can choose one of the starters in the list included or choose `None` to skip installing a storefront: @@ -107,6 +128,13 @@ yarn start The commands will differ based on your choices in previous prompts. + + --- ## Project Directory Structure @@ -116,14 +144,14 @@ Inside the root project directory which was specified at the beginning of the in ```bash noReport /my-medusa-store /storefront // Medusa storefront starter - /backend // Medusa starter as a backend option - /admin // Medusa admin panel + /backend // Medusa server + /admin // Medusa admin ``` --- ## What’s Next -- [Deploy the Medusa server](../deployments/server/index.mdx) -- [Deploy the Medusa admin](../deployments/admin/index.mdx) -- [Deploy the storefront](../deployments/storefront/index.mdx) +- [Check out Medusa's features](../introduction.md#features) +- [Learn about server configurations](./configurations.md) +- [Set up your environment for advanced development](../tutorial/0-set-up-your-development-environment.mdx) \ No newline at end of file diff --git a/www/docs/sidebars.js b/www/docs/sidebars.js index a9d41c29d4..9524ad6fa0 100644 --- a/www/docs/sidebars.js +++ b/www/docs/sidebars.js @@ -26,13 +26,25 @@ module.exports = { label: "Introduction", }, { - type: "doc", - id: "quickstart/quick-start", - label: "Quickstart Guide", - }, - { - type:"doc", - id: "quickstart/quick-start-docker", + type: "category", + label: "Install Medusa Server", + collapsed: false, + items: [ + { + type: "doc", + id: "quickstart/quick-start", + label: "Quickstart Guide", + }, + { + type: "doc", + id: "usage/create-medusa-app", + label: 'Use create-medusa-app' + }, + { + type:"doc", + id: "quickstart/quick-start-docker", + }, + ] }, { type: "doc", @@ -74,10 +86,6 @@ module.exports = { type: "doc", id: "admin/quickstart", }, - { - type: "doc", - id: "usage/create-medusa-app", - }, { type: "category", label: "Deployment", diff --git a/www/docs/static/img/user-guide-dark.svg b/www/docs/static/img/user-guide-dark.svg new file mode 100644 index 0000000000..40771ae99f --- /dev/null +++ b/www/docs/static/img/user-guide-dark.svg @@ -0,0 +1,3 @@ + + + diff --git a/www/docs/static/img/user-guide.svg b/www/docs/static/img/user-guide.svg new file mode 100644 index 0000000000..7462995921 --- /dev/null +++ b/www/docs/static/img/user-guide.svg @@ -0,0 +1,3 @@ + + + From c94ce03aa2ddd682170c544672ae632fdd4d9806 Mon Sep 17 00:00:00 2001 From: Shahed Nasser Date: Wed, 11 Jan 2023 17:36:29 +0200 Subject: [PATCH 2/6] docs: added upgrade guide for 1.7.3 (#2968) * docs: added upgrade guide for 1.7.3 * remove sales channel note --- .../advanced/backend/sales-channels/index.md | 11 ---- .../advanced/backend/upgrade-guides/1-7-3.md | 53 +++++++++++++++++++ www/docs/sidebars.js | 5 ++ 3 files changed, 58 insertions(+), 11 deletions(-) create mode 100644 docs/content/advanced/backend/upgrade-guides/1-7-3.md diff --git a/docs/content/advanced/backend/sales-channels/index.md b/docs/content/advanced/backend/sales-channels/index.md index 6101eaba79..69702035f9 100644 --- a/docs/content/advanced/backend/sales-channels/index.md +++ b/docs/content/advanced/backend/sales-channels/index.md @@ -2,17 +2,6 @@ In this document, you’ll learn about Sales Channels and how they can be used in Medusa. -:::note - -The Sales Channels feature is currently in beta mode and guarded by a feature flag. To use Sales Channels either: - -1. Enable the `MEDUSA_FF_SALES_CHANNELS` environment variable; -2. Or enable the `sales_channels` key in the Medusa server's settings. - -You can learn more about enabling it in the [feature flags](../feature-flags/toggle.md) documentation. - -::: - ## Introduction Sales Channels allow you to separate between the different channels you sell products in. For example, you can have a sales channel for your website and another for your mobile apps. diff --git a/docs/content/advanced/backend/upgrade-guides/1-7-3.md b/docs/content/advanced/backend/upgrade-guides/1-7-3.md new file mode 100644 index 0000000000..cfa8118fc1 --- /dev/null +++ b/docs/content/advanced/backend/upgrade-guides/1-7-3.md @@ -0,0 +1,53 @@ +--- +description: 'Actions Required for v.1.7.3' +--- + +# v1.7.3 + +Version 1.7.3 of Medusa changes the feature flag value for Sales Channels and Publishable API Keys. + +## Overview + +Sales Channels and Publishable API Keys were introduced in previous versions of Medusa, but guarded by [feature flags](../feature-flags/toggle.md) This meant that developers had to manually enable them to use them. + +Version 1.7.3 of Medusa keeps the feature flags for these two features, but they’re now enabled by default. This requires running the necessary migrations to ensure your server works as expected. + +--- + +## Actions Required + +### Run Migrations + +After updating your Medusa server and before running it, run the following command to run the latest migration: + +```bash +medusa migrations run +``` + +### Run Migration Script for Sales Channels + +With the introduction of Sales Channels, products are now associated with them. To avoid inconsistencies with how products are linked to Sales Channels, it’s strongly recommended to run a migration script before running the Medusa server. + +Start by adding the following environment variables: + +```bash +TYPEORM_CONNECTION=postgres +TYPEORM_URL= +TYPEORM_LOGGING=true +TYPEORM_ENTITIES=./node_modules/@medusajs/medusa/dist/models/*.js +TYPEORM_MIGRATIONS=./node_modules/@medusajs/medusa/dist/migrations/*.js +``` + +Make sure to replace `` with the connection URL of your database. + +Then, run the following command in the root of your Medusa server: + +```bash +node ./node_modules/@medusajs/medusa/dist/scripts/sales-channels-migration.js +``` + +--- + +## Disabling Feature Flags + +Although this version enables Sales Channels and Publishable API Keys by default, you can still turn them off using feature flags. Learn more in [this documentation](../feature-flags/toggle.md#disable-feature-flags) diff --git a/www/docs/sidebars.js b/www/docs/sidebars.js index 9524ad6fa0..3aa88c4ea4 100644 --- a/www/docs/sidebars.js +++ b/www/docs/sidebars.js @@ -182,6 +182,11 @@ module.exports = { id: 'advanced/backend/upgrade-guides/index' }, items: [ + { + type: "doc", + id: "advanced/backend/upgrade-guides/1-7-3", + label: "v1.7.3" + }, { type: "doc", id: "advanced/backend/upgrade-guides/1-7-1", From 4156e280ab7d170a51ecf4b4038faa2eaa302da8 Mon Sep 17 00:00:00 2001 From: Shahed Nasser Date: Wed, 11 Jan 2023 17:36:51 +0200 Subject: [PATCH 3/6] docs: added publishable API keys documentation pages (#2972) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs: added publishable api keys docs * Update docs/content/advanced/admin/manage-publishable-api-keys.mdx Co-authored-by: Frane Polić <16856471+fPolic@users.noreply.github.com> * Update publishable-api-keys.mdx * Update docs/content/advanced/storefront/use-sales-channels.mdx Co-authored-by: Oliver Windall Juhl <59018053+olivermrbl@users.noreply.github.com> * added note in admin how-to guide * added note in conceptual guide * Update docs/content/advanced/backend/publishable-api-keys/index.md Co-authored-by: Oliver Windall Juhl <59018053+olivermrbl@users.noreply.github.com> * small fixes Co-authored-by: Frane Polić <16856471+fPolic@users.noreply.github.com> Co-authored-by: Oliver Windall Juhl <59018053+olivermrbl@users.noreply.github.com> --- .../advanced/admin/manage-customers.mdx | 6 + .../admin/manage-publishable-api-keys.mdx | 531 ++++++++++++++++++ .../backend/publishable-api-keys/index.md | 111 ++++ .../storefront/use-sales-channels.mdx | 9 + docs/content/js-client/overview.md | 11 +- .../settings/publishable-api-keys.mdx | 116 ++++ .../add-channels-batch.ts | 4 +- .../create-publishable-api-key.ts | 17 +- .../delete-channels-batch.ts | 4 +- .../delete-publishable-api-key.ts | 10 +- .../get-publishable-api-key.ts | 11 +- ...list-publishable-api-key-sales-channels.ts | 6 +- .../list-publishable-api-keys.ts | 2 +- .../revoke-publishable-api-key.ts | 5 +- .../update-publishable-api-key.ts | 12 +- www/docs/sidebars.js | 10 + 16 files changed, 826 insertions(+), 39 deletions(-) create mode 100644 docs/content/advanced/admin/manage-publishable-api-keys.mdx create mode 100644 docs/content/advanced/backend/publishable-api-keys/index.md create mode 100644 docs/content/user-guide/settings/publishable-api-keys.mdx diff --git a/docs/content/advanced/admin/manage-customers.mdx b/docs/content/advanced/admin/manage-customers.mdx index 3d250b8f07..94b2734b26 100644 --- a/docs/content/advanced/admin/manage-customers.mdx +++ b/docs/content/advanced/admin/manage-customers.mdx @@ -122,6 +122,9 @@ medusa.admin.customers.create({ fetch(`/admin/customers`, { method: "POST", credentials: "include", + headers: { + "Content-Type": "application/json", + }, body: JSON.stringify({ email, password, @@ -191,6 +194,9 @@ medusa.admin.customers.update(customerId, { fetch(`/admin/customers/${customerId}`, { method: "POST", credentials: "include", + headers: { + "Content-Type": "application/json", + }, body: JSON.stringify({ first_name, }), diff --git a/docs/content/advanced/admin/manage-publishable-api-keys.mdx b/docs/content/advanced/admin/manage-publishable-api-keys.mdx new file mode 100644 index 0000000000..2c0e210121 --- /dev/null +++ b/docs/content/advanced/admin/manage-publishable-api-keys.mdx @@ -0,0 +1,531 @@ +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Manage Publishable API Keys + +In this document, you’ll learn how to manage the publishable API keys using the admin APIs. + +## Overview + +Publishable API keys allow you to associate a set of resources with an API key. You can then pass that API key in storefront requests to guarantee that processed or returned data is within the scope you defined when creating the API key. + +Currently, publishable API keys can only be associated with sales channels. + +Using the Admin APIs, you can manage your Publishable API Keys. + +:::note + +Publishable API keys are only for client-side use. They can be publicly accessible in your code, as they are not authorized for the Admin API. + +::: + +### Scenario + +You want to use or implement the following admin functionalities: + +- Manage publishable keys including listing, creating, updating, and deleting them. +- Manage sales channels associated with a publishable API key including listing, adding, and deleting them from the publishable API key. + +--- + +## Prerequisites + +### Medusa Components + +It is assumed that you already have a Medusa server installed and set up. If not, you can follow the [quickstart guide](../../quickstart/quick-start.mdx) to get started. + +### JS Client + +This guide includes code snippets to send requests to your Medusa server using Medusa’s JS Client, JavaScript’s Fetch API, or cURL. + +If you follow the JS Client code blocks, it’s assumed you already have [Medusa’s JS Client](../../js-client/overview.md) installed and have [created an instance of the client](../../js-client/overview.md#configuration). + +### Authenticated Admin User + +You must be an authenticated admin user before following along with the steps in the tutorial. + +You can learn more about [authenticating as an admin user in the API reference](/api/admin/#section/Authentication). + +--- + +## List Publishable API Keys + +You can retrieve a list of publishable API keys by sending a request to the [List Publishable API Keys](/api/admin/#tag/PublishableApiKey/operation/GetPublishableApiKeys) endpoint: + + + + +```ts +medusa.admin.publishableApiKeys.list() +.then(({ publishable_api_keys, count, limit, offset }) => { + console.log(publishable_api_keys) +}) +``` + + + + +```ts +fetch(`/admin/publishable-api-keys`, { + credentials: "include", +}) +.then((response) => response.json()) +.then(({ publishable_api_keys, count, limit, offset }) => { + console.log(publishable_api_keys) +}) +``` + + + + +```bash +curl -L -X GET '/admin/publishable-api-keys' \ +-H 'Authorization: Bearer ' +``` + + + + +This request does not require any path parameters. You can pass it optional query parameters related to expanding fields and pagination, which you can check out in the [API reference](/api/admin/#tag/PublishableApiKey/operation/GetPublishableApiKeys). + +This request returns the following data in the response: + +- `publishable_api_keys`: An array of publishable API keys. +- `limit`: The maximum number of keys that can be returned. +- `offset`: The number of keys skipped in the result. +- `count`: The total number of keys available. + +:::note + +You can learn more about pagination in the [API reference](/api/admin/#section/Pagination). + +::: + +--- + +## Create a Publishable API Key + +You can create a publishable API key by sending a request to the [Create Publishable API Key](/api/admin/#tag/PublishableApiKey/operation/PostPublishableApiKeys) endpoint: + + + + +```ts +medusa.admin.publishableApiKeys.create({ + title: "Web API Key", +}) +.then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) +}) +``` + + + + +```ts +fetch(`/admin/publishable-api-keys`, { + method: "POST", + credentials: "include", + headers: { + "Content-Type": "application/json", + }, + body: JSON.stringify({ + title: "Web API Key", + }), +}) +.then((response) => response.json()) +.then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) +}) +``` + + + + +```bash +curl -L -X POST '/admin/publishable-api-keys' \ +-H 'Authorization: Bearer ' \ +-H 'Content-Type: application/json' \ +--data-raw '{ + "title": "Web API Key" +}' +``` + + + + +This request requires a body parameter `title`, which is the title of the Publishable API Key. + +It returns the created publishable API key in the response. + +--- + +## Update a Publishable API Key + +You can update a publishable API key’s details by sending a request to the [Update Publishable API Key](/api/admin/#tag/PublishableApiKey/operation/PostPublishableApiKysPublishableApiKey) endpoint: + + + + +```ts +medusa.admin.publishableApiKeys.update(publishableApiKeyId, { + title: "Web API Key", +}) +.then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) +}) +``` + + + + +```ts +fetch(`/admin/publishable-api-keys/${publishableApiKeyId}`, { + method: "POST", + credentials: "include", + headers: { + "Content-Type": "application/json", + }, + body: JSON.stringify({ + title: "Web API Key", + }), +}) +.then((response) => response.json()) +.then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) +}) +``` + + + + +```bash +curl -L -X POST '/admin/publishable-api-keys/' \ +-H 'Authorization: Bearer ' \ +-H 'Content-Type: application/json' \ +--data-raw '{ + "title": "Web API Key" +}' +``` + + + + +This request requires the ID of the publishable API key as a path parameter. In its body, it optionally accepts the new `title` of the publishable API key. + +This request returns the update publishable API key object in the response. + +--- + +## Revoke a Publishable API Key + +Revoking a publishable API key does not remove it, but does not allow using it in future requests. + +You can revoke a publishable API key by sending a request to the [Revoke Publishable API Key](/api/admin/#tag/PublishableApiKey/operation/PostPublishableApiKeysPublishableApiKeyRevoke) endpoint: + + + + +```ts +medusa.admin.publishableApiKeys.revoke(publishableApiKeyId) +.then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) +}) +``` + + + + +```ts +fetch( + `/admin/publishable-api-keys/${publishableApiKeyId}/revoke`, + { + method: "POST", + credentials: "include", + } +) +.then((response) => response.json()) +.then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) +}) +``` + + + + +```bash +curl -L -X POST '/admin/publishable-api-keys//revoke' \ +-H 'Authorization: Bearer ' +``` + + + + +This request requires the ID of the publishable API key as a path parameter. It returns the updated publishable API key in the response. + +--- + +## Delete a Publishable API Key + +You can delete a publishable API key by sending a request to the [Delete Publishable API Key](/api/admin/#tag/PublishableApiKey/operation/DeletePublishableApiKeysPublishableApiKey) endpoint: + + + + +```ts +medusa.admin.publishableApiKeys.delete(publishableApiKeyId) +.then(({ id, object, deleted }) => { + console.log(id) +}) +``` + + + + +```ts +fetch(`/admin/publishable-api-keys/${publishableApiKeyId}`, { + method: "DELETE", + credentials: "include", +}) +.then((response) => response.json()) +.then(({ id, object, deleted }) => { + console.log(id) +}) +``` + + + + +```bash +curl -L -X DELETE '/admin/publishable-api-keys/' \ +-H 'Authorization: Bearer ' +``` + + + + +This request requires the ID of the publishable API key as a path parameter. + +It returns the following data in the response: + +- `id`: The ID of the deleted publishable API key. +- `object`: A string indicating the type of object deleted. By default, its value is `publishable_api_key`. +- `deleted`: A boolean value indicating whether the publishable API key was deleted or not. + +--- + +## Manage Sales Channels of Publishable API Keys + +This section covers how to manage sales channels in a publishable API key. This doesn’t affect sales channels and their data, only its association with the publishable API key. + +### List Sales Channels of a Publishable API Key + +You can retrieve the list of sales channels associated with a publishable API key by sending a request to the [List Sales Channels](/api/admin/#tag/PublishableApiKey/operation/GetPublishableApiKeySalesChannels) endpoint: + + + + +```ts +medusa.admin.publishableApiKeys.listSalesChannels(publishableApiKeyId) +.then(({ sales_channels }) => { + console.log(sales_channels) +}) +``` + + + + + + +```ts +fetch( + `/admin/publishable-api-keys/${publishableApiKeyId}/sales-channels`, + { + credentials: "include", + } +) +.then((response) => response.json()) +.then(({ sales_channels }) => { + console.log(sales_channels) +}) +``` + + + + +```bash +curl -L -X GET '/admin/publishable-api-keys//sales-channels' \ +-H 'Authorization: Bearer ' +``` + + + + +This request requires the ID of the publishable API key as a path parameter. + +It returns an array of sales channels associated with the publishable API key in the response. + +### Add Sales Channels to Publishable API Key + +You can add a sales channel to a publishable API key by sending a request to the [Add Sales Channels](/api/admin/#tag/PublishableApiKey/operation/PostPublishableApiKeySalesChannelsChannelsBatch) endpoint: + + + + +```ts +medusa.admin.publishableApiKeys.addSalesChannelsBatch( + publishableApiKeyId, + { + sales_channel_ids: [ + { + id: salesChannelId, + }, + ], + } +) +.then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) +}) +``` + + + + + + +```ts +fetch( + `/admin/publishable-api-keys/${publishableApiKeyId}/sales-channels/batch`, + { + method: "POST", + credentials: "include", + headers: { + "Content-Type": "application/json", + }, + body: JSON.stringify({ + sales_channel_ids: [ + { + id: salesChannelId, + }, + ], + }), + } +) +.then((response) => response.json()) +.then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) +}) +``` + + + + +```bash +curl -L -X POST '/admin/publishable-api-keys//sales-channels/batch' \ +-H 'Authorization: Bearer ' \ +-H 'Content-Type: application/json' \ +--data-raw '{ + "sales_channel_ids": [ + { + "id": "" + } + ] +}' +``` + + + + +This request requires passing the ID of the publishable API key as a path parameter. + +In its body parameters, it’s required to pass the `sales_channel_ids` array parameter. Each item in the array is an object containing an `id` property, with its value being the ID of the sales channel to add to the publishable API key. + +You can add more than one sales channel in the same request by passing each of them as an object in the array. + +This request returns the updated publishable API key in the response. + +### Delete Sales Channels from a Publishable API Key + +You can delete a sales channel from a publishable API key by sending a request to the [Delete Sales Channels](/api/admin/#tag/PublishableApiKey/operation/DeletePublishableApiKeySalesChannelsChannelsBatch) endpoint: + + + + +```ts +medusa.admin.publishableApiKeys.deleteSalesChannelsBatch( + publishableApiKeyId, + { + sales_channel_ids: [ + { + id: salesChannelId, + }, + ], + } +) +.then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) +}) +``` + + + + + + +```ts +fetch( + `/admin/publishable-api-keys/${publishableApiKeyId}/sales-channels/batch`, + { + method: "DELETE", + credentials: "include", + headers: { + "Content-Type": "application/json", + }, + body: JSON.stringify({ + sales_channel_ids: [ + { + id: salesChannelId, + }, + ], + }), + } +) +.then((response) => response.json()) +.then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) +}) +``` + + + + +```bash +curl -L -X DELETE '/admin/publishable-api-keys//sales-channels/batch' \ +-H 'Authorization: Bearer ' \ +-H 'Content-Type: application/json' \ +--data-raw '{ + "sales_channel_ids": [ + { + "id": "" + } + ] +}' +``` + + + + +This request requires the ID of the publishable API key as a path parameter. + +In its body parameters, it’s required to pass the `sales_channel_ids` array parameter. Each item in the array is an object containing an `id` property, with its value being the ID of the sales channel to delete from the publishable API key. + +You can delete more than one sales channel in the same request by passing each of them as an object in the array. + +This request returns the updated publishable API key in the response. + +--- + +## See Also + +- [Publishable API key overview](../backend/publishable-api-keys/index.md) +- [Publishable API key admin API reference](/api/admin/#tag/PublishableApiKey) diff --git a/docs/content/advanced/backend/publishable-api-keys/index.md b/docs/content/advanced/backend/publishable-api-keys/index.md new file mode 100644 index 0000000000..5cdd03abb9 --- /dev/null +++ b/docs/content/advanced/backend/publishable-api-keys/index.md @@ -0,0 +1,111 @@ +# Publishable API Keys Overview + +In this document, you’ll learn about Publishable API Keys and their usage. + +## Introduction + +While using Medusa’s APIs, you might have to pass some query parameters for certain resources with every or most requests. + +Taking Sales Channels as an example, you have to pass the Sales Channel’s ID as a query parameter to all the necessary endpoints, such as the List Products endpoint. + +This is a tedious and error-prone process. This is where Publishable API Keys are useful. + +Publishable API Keys can be used to scope API calls with an API key, determining what resources are retrieved when querying the API. Currently, they can be associated only with Sales Channels. + +For example, you can associate an API key with a B2B channel, then, on the storefront, retrieve only products available in that channel using the API key. + +--- + +## PublishableApiKey Entity Overview + +The `PublishableApiKey` entity represents a publishable API key that is stored in the database. Some of its important attributes include: + +- `id`: The ID of the publishable API key. This is the API key you’ll use in your API requests. +- `created_by`: The ID of the user that created this API key. +- `revoked_by`: The ID of the user that revoked this API key. A revoked publishable API key cannot be used in requests. + +--- + +## Relation to Other Entities + +### Sales Channels + +A publishable API key can be associated with more than one sales channel, and a sales channel can be associated with more than one publishable API key. + +The relation is represented by the entity `PublishableApiKeySalesChannel`. + +--- + +## Using Publishable API Keys in Requests + +:::note + +Publishable API keys are only for client-side use. They can be publicly accessible in your code, as they are not authorized for the Admin API. + +::: + +### Using Medusa JS Client + +When using [Medusa’s JS Client](../../../js-client/overview.md), you can pass it to the client only once when you create the instance of the client: + +```ts +const medusa = new Medusa({ + maxRetries: 3, + baseUrl: "https://api.example.com", + publishableApiKey, +}) +``` + +This will add the API key as in the header parameter `x-publishable-api-key` on all requests. + +You can also use the `setPublishableKey` method to set it at a later point: + +```ts +const medusa = new Medusa({ + // ... +}) + +// at a later point +medusa.setPublishableKey(publishableApiKey) +``` + +### Using Medusa React + +You can pass the publishable API key to the `MedusaProvider` component: + +```tsx +const App = () => { + return ( + + + + ) +} +``` + +Then, the API key will be passed in the header parameter `x-publishable-api-key` of every request. + +### Using Other Methods + +For other ways of sending requests to your Medusa server, such as using the Fetch API, you must pass `x-publishable-api-key` in the header of every request. Its value is the publishable API key’s `id`. + +```ts +fetch(`/store/products`, { + credentials: "include", + headers: { + "x-publishable-api-key": publishableApiKey, + }, +}) +``` + +--- + +## See Also + +- [How to manage publishable keys as an admin](../../admin/manage-publishable-api-keys.mdx) +- [Publishable API keys admin API reference](/api/admin/#tag/PublishableApiKey) diff --git a/docs/content/advanced/storefront/use-sales-channels.mdx b/docs/content/advanced/storefront/use-sales-channels.mdx index 712b53898f..2b17601744 100644 --- a/docs/content/advanced/storefront/use-sales-channels.mdx +++ b/docs/content/advanced/storefront/use-sales-channels.mdx @@ -11,6 +11,15 @@ In your storefront, you can filter products by sales channels. You can also asso This guide explains how to perform these operations using the Storefront APIs. +### Alternative Approach: Publishable API keys + +This guide covers how to pass the sales channel ID into different requests to retrieve or process data associated with the sales channel. + +An alternative approach is to use Publishable API keys. You can learn how to use them in the following documents: + +- [Using publishable API keys in requests](../backend/publishable-api-keys/index.md) +- Managing publishable API keys using [admin APIs](../admin/manage-publishable-api-keys.mdx) or using [Medusa Admin](../../user-guide/settings/publishable-api-keys.mdx) + --- ## Prerequisites diff --git a/docs/content/js-client/overview.md b/docs/content/js-client/overview.md index 4b5e254cdc..e365be4f2d 100644 --- a/docs/content/js-client/overview.md +++ b/docs/content/js-client/overview.md @@ -80,8 +80,9 @@ const medusa = new Medusa({ }) ``` -| Option | Default | Description | -| ------------ | ------------------------- | --------------------------------------------------------- | -| `maxRetries` | `0` | The amount of times a request is retried. | -| `baseUrl` | `'http://localhost:9000'` | The url to which requests are made to. | -| `apiKey` | `''` | Optional api key used for authenticating admin requests . | \ No newline at end of file +| Option | Default | Description | +| ------------------- | ------------------------- | --------------------------------------------------------- | +| `maxRetries` | `0` | The amount of times a request is retried. | +| `baseUrl` | `'http://localhost:9000'` | The url to which requests are made to. | +| `apiKey` | `''` | Optional api key used for authenticating admin requests . | +| `publishableApiKey` | `''` | Optional publishable API key used for storefront requests.| \ No newline at end of file diff --git a/docs/content/user-guide/settings/publishable-api-keys.mdx b/docs/content/user-guide/settings/publishable-api-keys.mdx new file mode 100644 index 0000000000..ccb49e4bbd --- /dev/null +++ b/docs/content/user-guide/settings/publishable-api-keys.mdx @@ -0,0 +1,116 @@ +--- +sidebar_position: 4 +--- + +import UiIcon from '@site/src/components/UiIcon'; + +# Manage Publishable API Keys + +In this document, you’ll learn how to manage publishable API keys in Medusa Admin. + +## Overview + +Publishable API keys are used by developers or technical teams. They are used to define the resources that an API key is associated with and can access. + +Then, this publishable API key is used in storefront development to retrieve or process data based on the scope of the publishable API key. + +Currently, publishable API keys can only be used with sales channels. + +--- + +## Create Publishable API Key + +To create a publishable API key: + +1. Go to Settings → API key management. +2. Click on the “Create API key” button at the top right. +3. In the new form that opens: + 1. Enter a name for the API key in the Title field. + 2. You can optionally add sales channels. To do that: + 1. Click on the “Add sales channels” button. + 2. Click on the checkbox next to the sales channels you want to add. + 3. Click on the “Save and close” button. +4. Once you’re done, click on the “Publish API key” button. + +--- + +## Copy Token of API Key + +To copy the token of an API key: + +1. Go to Settings → API key management. +2. Click on the icon next to the API key you want to copy. +3. Click on “Copy token” from the dropdown. + +--- + +## Edit API Key Details + +To edit the details of an API key: + +1. Go to Settings → API key management. +2. Click on the icon next to the API key you want to edit. +3. Click on “Edit API key details” from the dropdown. +4. Change the title of the API Key in the side window that opens. +5. Click on the “Save and close” button. + +--- + +## Manage Sales Channels of a Publishable API Key + +:::info + +Making any changes in the sales channels here does not affect the sales channel itself or any of its data. This only impacts the relation between sales channels and publishable API keys. + +::: + +You can add or delete sales channels from a publishable API key. Adding a sales channel makes it accessible using the publishable API key. Removing a sales channel from a publishable API key removes the API key’s access to the sales channel. + +To manage sales channels of a publishable API key: + +1. Go to Settings → API key management. +2. Click on the icon next to the API key you want to manage its sales channels. +3. Click on “Edit sales channels” from the dropdown. +4. In the side window that opens: + 1. To add a sales channel to the publishable API key: + 1. Click on the “Add channels” button. + 2. Click on the checkbox next to the sales channels you want to add. + 3. Once done, click on the “Add and go back” button to add the sales channels and continue editing, or click on the “Add and close” to add the sales channels and close the side menu. + 2. To delete a sales channel from the publishable API key: + 1. Click on the checkbox next to the sales channels you want to delete. + 2. Click on the “Remove” button. +5. Once you’re done editing, click on the Close button. + +--- + +## Revoke Publishable API Key + +:::warning + +Revoking a publishable API key does not remove it, but the API key can’t be used in development anymore. It can't be undone. + +::: + +To revoke a publishable API key: + +1. Go to Settings → API key management. +2. Click on the icon next to the API key you want to revoke. +3. Click on “Revoke token” from the dropdown. +4. Confirm revoking the publishable API key by clicking the “Yes, revoke” button in the pop-up. + +--- + +## Delete Publishable API Key + +:::warning + +Deleting a publishable API key completely removes it and the API key can’t be used in development anymore. It can't be undone. + +::: + +To delete a publishable API key: + +1. Go to Settings → API key management. +2. Click on the icon next to the API key you want to delete. +3. Click on “Delete API key” from the dropdown. +4. Confirm deleting the publishable API key by clicking the “Yes, delete” button in the pop-up. diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/add-channels-batch.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/add-channels-batch.ts index 9de91351d9..e6a0e1fff1 100644 --- a/packages/medusa/src/api/routes/admin/publishable-api-keys/add-channels-batch.ts +++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/add-channels-batch.ts @@ -26,7 +26,7 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key" * import Medusa from "@medusajs/medusa-js" * const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) * // must be previously logged in or use api token - * medusa.admin.publishableApiKeys.addSalesChannels(publishableApiKeyId, { + * medusa.admin.publishableApiKeys.addSalesChannelsBatch(publishableApiKeyId, { * sales_channel_ids: [ * { * id: channel_id @@ -39,7 +39,7 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key" * - lang: Shell * label: cURL * source: | - * curl --location --request POST 'https://medusa-url.com/admin/publishable-api-keys/afasf/batch' \ + * curl --location --request POST 'https://medusa-url.com/admin/publishable-api-keys/{pak_id}/batch' \ * --header 'Authorization: Bearer {api_token}' \ * --header 'Content-Type: application/json' \ * --data-raw '{ diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/create-publishable-api-key.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/create-publishable-api-key.ts index a480f588b6..74fe6f1ce5 100644 --- a/packages/medusa/src/api/routes/admin/publishable-api-keys/create-publishable-api-key.ts +++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/create-publishable-api-key.ts @@ -22,16 +22,21 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key" * import Medusa from "@medusajs/medusa-js" * const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) * // must be previously logged in or use api token - * medusa.admin.publishableApiKey.create() - * .then(({ publishable_api_key }) => { - * console.log(publishable_api_key.id) - * }) + * medusa.admin.publishableApiKeys.create({ + * title + * }) + * .then(({ publishable_api_key }) => { + * console.log(publishable_api_key.id) + * }) * - lang: Shell * label: cURL * source: | * curl --location --request POST 'https://medusa-url.com/admin/publishable-api-keys' \ - * --header 'Authorization: Bearer {api_token}' - * -d '{ "created_by": "user_123" }' + * --header 'Authorization: Bearer {api_token}' \ + * --header 'Content-Type: application/json' \ + * --data-raw '{ + * "title": "Web API Key" + * }' * security: * - api_token: [] * - cookie_auth: [] diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-channels-batch.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-channels-batch.ts index 4c1d40206e..eb492c473a 100644 --- a/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-channels-batch.ts +++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-channels-batch.ts @@ -26,7 +26,7 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key" * import Medusa from "@medusajs/medusa-js" * const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) * // must be previously logged in or use api token - * medusa.admin.publishableApiKeys.removeSalesChannels(publishableApiKeyId, { + * medusa.admin.publishableApiKeys.deleteSalesChannelsBatch(publishableApiKeyId, { * sales_channel_ids: [ * { * id: channel_id @@ -39,7 +39,7 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key" * - lang: Shell * label: cURL * source: | - * curl --location --request DELETE 'https://medusa-url.com/admin/publishable-api-keys/afasf/batch' \ + * curl --location --request DELETE 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}/batch' \ * --header 'Authorization: Bearer {api_token}' \ * --header 'Content-Type: application/json' \ * --data-raw '{ diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-publishable-api-key.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-publishable-api-key.ts index 25d69f06a0..8ab4f63e14 100644 --- a/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-publishable-api-key.ts +++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/delete-publishable-api-key.ts @@ -17,14 +17,14 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key" * import Medusa from "@medusajs/medusa-js" * const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) * // must be previously logged in or use api token - * medusa.admin.publishableApiKey.delete(key_id) - * .then(({ id, object, deleted }) => { - * console.log(id) - * }) + * medusa.admin.publishableApiKeys.delete(publishableApiKeyId) + * .then(({ id, object, deleted }) => { + * console.log(id) + * }) * - lang: Shell * label: cURL * source: | - * curl --location --request DELETE 'https://medusa-url.com/admin/publishable-api-key/{id}' \ + * curl --location --request DELETE 'https://medusa-url.com/admin/publishable-api-key/{pka_id}' \ * --header 'Authorization: Bearer {api_token}' * security: * - api_token: [] diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/get-publishable-api-key.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/get-publishable-api-key.ts index 4223587400..d8db2cd23f 100644 --- a/packages/medusa/src/api/routes/admin/publishable-api-keys/get-publishable-api-key.ts +++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/get-publishable-api-key.ts @@ -17,16 +17,15 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key" * import Medusa from "@medusajs/medusa-js" * const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) * // must be previously logged in or use api token - * medusa.admin.publishableApiKey.retrieve(pubKeyId) - * .then(({ publishable_api_key }) => { - * console.log(publishable_api_key.id) - * }) + * medusa.admin.publishableApiKeys.retrieve(publishableApiKeyId) + * .then(({ publishable_api_key }) => { + * console.log(publishable_api_key.id) + * }) * - lang: Shell * label: cURL * source: | - * curl --location --request GET 'https://medusa-url.com/admin/publishable-api-keys/pubkey_123' \ + * curl --location --request GET 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}' \ * --header 'Authorization: Bearer {api_token}' - * -d '{ "created_by": "user_123" }' * security: * - api_token: [] * - cookie_auth: [] diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/list-publishable-api-key-sales-channels.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/list-publishable-api-key-sales-channels.ts index 47d575c5d5..489ee2e59b 100644 --- a/packages/medusa/src/api/routes/admin/publishable-api-keys/list-publishable-api-key-sales-channels.ts +++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/list-publishable-api-key-sales-channels.ts @@ -21,13 +21,13 @@ import { extendedFindParamsMixin } from "../../../../types/common" * const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) * // must be previously logged in or use api token * medusa.admin.publishableApiKeys.listSalesChannels() - * .then(({ sales_channels, limit, offset, count }) => { - * console.log(sales_channels) + * .then(({ sales_channels }) => { + * console.log(sales_channels.length) * }) * - lang: Shell * label: cURL * source: | - * curl --location --request GET 'https://medusa-url.com/admin/publishable-api-keys/pk_123/sales-channels' \ + * curl --location --request GET 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}/sales-channels' \ * --header 'Authorization: Bearer {api_token}' * security: * - api_token: [] diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/list-publishable-api-keys.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/list-publishable-api-keys.ts index e943b1643d..fb966289c0 100644 --- a/packages/medusa/src/api/routes/admin/publishable-api-keys/list-publishable-api-keys.ts +++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/list-publishable-api-keys.ts @@ -24,7 +24,7 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key" * const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) * // must be previously logged in or use api token * medusa.admin.publishableApiKeys.list() - * .then(({ publishable_api_keys }) => { + * .then(({ publishable_api_keys, count, limit, offset }) => { * console.log(publishable_api_keys) * }) * - lang: Shell diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/revoke-publishable-api-key.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/revoke-publishable-api-key.ts index 863934838a..f5c0120372 100644 --- a/packages/medusa/src/api/routes/admin/publishable-api-keys/revoke-publishable-api-key.ts +++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/revoke-publishable-api-key.ts @@ -18,16 +18,15 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key" * import Medusa from "@medusajs/medusa-js" * const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) * // must be previously logged in or use api token - * medusa.admin.publishableApiKey.revoke() + * medusa.admin.publishableApiKeys.revoke(publishableApiKeyId) * .then(({ publishable_api_key }) => { * console.log(publishable_api_key.id) * }) * - lang: Shell * label: cURL * source: | - * curl --location --request POST 'https://medusa-url.com/admin/publishable-api-keys/pubkey_123/revoke' \ + * curl --location --request POST 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}/revoke' \ * --header 'Authorization: Bearer {api_token}' - * -d '{ "created_by": "user_123", "revoked_by": "user_123" }' * security: * - api_token: [] * - cookie_auth: [] diff --git a/packages/medusa/src/api/routes/admin/publishable-api-keys/update-publishable-api-key.ts b/packages/medusa/src/api/routes/admin/publishable-api-keys/update-publishable-api-key.ts index 6d5d33ee6b..8b06e2d607 100644 --- a/packages/medusa/src/api/routes/admin/publishable-api-keys/update-publishable-api-key.ts +++ b/packages/medusa/src/api/routes/admin/publishable-api-keys/update-publishable-api-key.ts @@ -24,20 +24,20 @@ import PublishableApiKeyService from "../../../../services/publishable-api-key" * import Medusa from "@medusajs/medusa-js" * const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) * // must be previously logged in or use api token - * medusa.admin.publishableApiKey.update(publishable_key_id, { + * medusa.admin.publishableApiKeys.update(publishableApiKeyId, { * title: "new title" * }) - * .then(({ publishable_api_key }) => { - * console.log(publishable_api_key.id) - * }) + * .then(({ publishable_api_key }) => { + * console.log(publishable_api_key.id) + * }) * - lang: Shell * label: cURL * source: | - * curl --location --request POST 'https://medusa-url.com/admin/publishable-api-key/{id}' \ + * curl --location --request POST 'https://medusa-url.com/admin/publishable-api-key/{pka_id}' \ * --header 'Authorization: Bearer {api_token}' \ * --header 'Content-Type: application/json' \ * --data-raw '{ - * "title": "updated title" + * "title": "new title" * }' * security: * - api_token: [] diff --git a/www/docs/sidebars.js b/www/docs/sidebars.js index 3aa88c4ea4..024e23349a 100644 --- a/www/docs/sidebars.js +++ b/www/docs/sidebars.js @@ -356,6 +356,11 @@ module.exports = { id: "advanced/backend/sales-channels/manage-admin", label: "Manage Sales Channels" }, + { + type: "doc", + id: "advanced/admin/manage-publishable-api-keys", + label: "Manage PublishableApiKeys" + }, ] }, { @@ -530,6 +535,11 @@ module.exports = { type: "doc", id: "advanced/backend/gift-cards/index" }, + { + type: "doc", + id: "advanced/backend/publishable-api-keys/index", + label: "Publishable API Keys" + }, ] }, { From 0d9e3e86dd79224ab216978d8930a45adeda1b16 Mon Sep 17 00:00:00 2001 From: Oliver Windall Juhl <59018053+olivermrbl@users.noreply.github.com> Date: Wed, 11 Jan 2023 16:37:00 +0100 Subject: [PATCH 4/6] docs: Temporarily remove note on peer deps in documentation (#2988) * docs: Temporarily remove note on peer deps in documentation * Update docs/content/advanced/backend/plugins/create.md Co-authored-by: Shahed Nasser Co-authored-by: Shahed Nasser --- .../advanced/backend/plugins/create.md | 22 +------------------ 1 file changed, 1 insertion(+), 21 deletions(-) diff --git a/docs/content/advanced/backend/plugins/create.md b/docs/content/advanced/backend/plugins/create.md index f2f21a2886..00b160a80d 100644 --- a/docs/content/advanced/backend/plugins/create.md +++ b/docs/content/advanced/backend/plugins/create.md @@ -60,27 +60,7 @@ A basic Medusa server installed with the `medusa new` command has dependencies s } ``` -For a plugin, a lot of these dependencies are not necessary or should be labeled as [peer dependencies](https://docs.npmjs.com/cli/v8/configuring-npm/package-json#peerdependencies). Therefore, it’s important to make changes to the dependencies of your plugin. - -The recommended change is the following: - -```json title=package.json -"peerDependencies": { - "@medusajs/medusa": "^1.3.1", - "medusa-interfaces": "^1.3.0", - "typeorm": "^0.2.36" -}, -"devDependencies": { - "@babel/cli": "^7.14.3", - "@babel/core": "^7.14.3", - "@babel/preset-typescript": "^7.14.5", - "babel-preset-medusa-package": "^1.1.19", -} -``` - -The packages `@medusajs/medusa` and `medusa-interfaces` act as peer dependencies. They’ll be installed while you develop your package, and they are required when your plugin is installed in another NPM project. - -You remove the packages `medusa-fulfillment-manual`, `medusa-payment-manual`, and `medusa-payment-stripe` as they are fulfillment and payment plugins necessary for a Medusa server, but not for a plugin. +For a plugin, some dependencies are not necessary. You can remove the packages `medusa-fulfillment-manual`, `medusa-payment-manual`, and `medusa-payment-stripe` as they are fulfillment and payment plugins necessary for a Medusa server, but not for a plugin. Additionally, you remove `@medusajs/medusa-cli` as you don’t need to use the Medusa CLI while developing a plugin. From f20cdeb680319232878a0f85dfb536890dd5f02e Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 11 Jan 2023 17:41:01 +0200 Subject: [PATCH 5/6] chore(docs): Generated Docs Announcement Bar (automated) (#2990) Co-authored-by: olivermrbl --- www/docs/announcement.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/www/docs/announcement.json b/www/docs/announcement.json index 9e26dfeeb6..2136f7f2cb 100644 --- a/www/docs/announcement.json +++ b/www/docs/announcement.json @@ -1 +1 @@ -{} \ No newline at end of file +{"id":"https://github.com/medusajs/medusa/releases/tag/v1.7.3","content":"v1.7.3 is out","isCloseable":true} \ No newline at end of file From 3b632c513047931a8beccbd004349eb7bfc979e4 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 11 Jan 2023 17:43:03 +0200 Subject: [PATCH 6/6] chore(docs): Generated API Reference (#2991) Co-authored-by: shahednasser --- docs/api/admin-spec3.json | 78 ++++++++++--------- docs/api/admin-spec3.yaml | 78 ++++++++++--------- .../publishable-api-key_{id}/postundefined | 8 +- .../publishable-api-keys/getundefined | 2 +- .../publishable-api-keys/postundefined | 10 ++- .../publishable-api-keys_{id}/deleteundefined | 8 +- .../publishable-api-keys_{id}/getundefined | 8 +- .../postundefined | 2 +- .../getundefined | 4 +- .../deleteundefined | 2 +- .../postundefined | 2 +- .../publishable-api-key_{id}/postundefined | 4 +- .../Shell/publishable-api-keys/postundefined | 7 +- .../publishable-api-keys_{id}/deleteundefined | 2 +- .../publishable-api-keys_{id}/getundefined | 3 +- .../postundefined | 3 +- .../getundefined | 2 +- .../deleteundefined | 2 +- .../postundefined | 2 +- 19 files changed, 121 insertions(+), 106 deletions(-) diff --git a/docs/api/admin-spec3.json b/docs/api/admin-spec3.json index b3a3a5a979..3a591aca54 100644 --- a/docs/api/admin-spec3.json +++ b/docs/api/admin-spec3.json @@ -12314,7 +12314,7 @@ paths: // must be previously logged in or use api token - medusa.admin.publishableApiKeys.addSalesChannels(publishableApiKeyId, + medusa.admin.publishableApiKeys.addSalesChannelsBatch(publishableApiKeyId, { sales_channel_ids: [ { @@ -12330,7 +12330,7 @@ paths: label: cURL source: > curl --location --request POST - 'https://medusa-url.com/admin/publishable-api-keys/afasf/batch' \ + 'https://medusa-url.com/admin/publishable-api-keys/{pak_id}/batch' \ --header 'Authorization: Bearer {api_token}' \ @@ -12398,7 +12398,7 @@ paths: // must be previously logged in or use api token - medusa.admin.publishableApiKeys.removeSalesChannels(publishableApiKeyId, + medusa.admin.publishableApiKeys.deleteSalesChannelsBatch(publishableApiKeyId, { sales_channel_ids: [ { @@ -12414,7 +12414,7 @@ paths: label: cURL source: > curl --location --request DELETE - 'https://medusa-url.com/admin/publishable-api-keys/afasf/batch' \ + 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}/batch' \ --header 'Authorization: Bearer {api_token}' \ @@ -12475,19 +12475,26 @@ paths: // must be previously logged in or use api token - medusa.admin.publishableApiKey.create() - .then(({ publishable_api_key }) => { - console.log(publishable_api_key.id) - }) + medusa.admin.publishableApiKeys.create({ + title + }) + + .then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) + }) - lang: Shell label: cURL source: > curl --location --request POST 'https://medusa-url.com/admin/publishable-api-keys' \ - --header 'Authorization: Bearer {api_token}' + --header 'Authorization: Bearer {api_token}' \ - -d '{ "created_by": "user_123" }' + --header 'Content-Type: application/json' \ + + --data-raw '{ + "title": "Web API Key" + }' security: - api_token: [] - cookie_auth: [] @@ -12560,7 +12567,7 @@ paths: // must be previously logged in or use api token medusa.admin.publishableApiKeys.list() - .then(({ publishable_api_keys }) => { + .then(({ publishable_api_keys, count, limit, offset }) => { console.log(publishable_api_keys) }) - lang: Shell @@ -12622,15 +12629,16 @@ paths: // must be previously logged in or use api token - medusa.admin.publishableApiKey.delete(key_id) - .then(({ id, object, deleted }) => { - console.log(id) - }) + medusa.admin.publishableApiKeys.delete(publishableApiKeyId) + + .then(({ id, object, deleted }) => { + console.log(id) + }) - lang: Shell label: cURL source: > curl --location --request DELETE - 'https://medusa-url.com/admin/publishable-api-key/{id}' \ + 'https://medusa-url.com/admin/publishable-api-key/{pka_id}' \ --header 'Authorization: Bearer {api_token}' security: @@ -12682,19 +12690,18 @@ paths: // must be previously logged in or use api token - medusa.admin.publishableApiKey.retrieve(pubKeyId) - .then(({ publishable_api_key }) => { - console.log(publishable_api_key.id) - }) + medusa.admin.publishableApiKeys.retrieve(publishableApiKeyId) + + .then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) + }) - lang: Shell label: cURL source: > curl --location --request GET - 'https://medusa-url.com/admin/publishable-api-keys/pubkey_123' \ + 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}' \ --header 'Authorization: Bearer {api_token}' - - -d '{ "created_by": "user_123" }' security: - api_token: [] - cookie_auth: [] @@ -12752,14 +12759,14 @@ paths: // must be previously logged in or use api token medusa.admin.publishableApiKeys.listSalesChannels() - .then(({ sales_channels, limit, offset, count }) => { - console.log(sales_channels) + .then(({ sales_channels }) => { + console.log(sales_channels.length) }) - lang: Shell label: cURL source: > curl --location --request GET - 'https://medusa-url.com/admin/publishable-api-keys/pk_123/sales-channels' + 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}/sales-channels' \ --header 'Authorization: Bearer {api_token}' @@ -12815,7 +12822,7 @@ paths: // must be previously logged in or use api token - medusa.admin.publishableApiKey.revoke() + medusa.admin.publishableApiKeys.revoke(publishableApiKeyId) .then(({ publishable_api_key }) => { console.log(publishable_api_key.id) }) @@ -12823,12 +12830,10 @@ paths: label: cURL source: > curl --location --request POST - 'https://medusa-url.com/admin/publishable-api-keys/pubkey_123/revoke' + 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}/revoke' \ --header 'Authorization: Bearer {api_token}' - - -d '{ "created_by": "user_123", "revoked_by": "user_123" }' security: - api_token: [] - cookie_auth: [] @@ -12886,24 +12891,25 @@ paths: // must be previously logged in or use api token - medusa.admin.publishableApiKey.update(publishable_key_id, { + medusa.admin.publishableApiKeys.update(publishableApiKeyId, { title: "new title" }) - .then(({ publishable_api_key }) => { - console.log(publishable_api_key.id) - }) + + .then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) + }) - lang: Shell label: cURL source: > curl --location --request POST - 'https://medusa-url.com/admin/publishable-api-key/{id}' \ + 'https://medusa-url.com/admin/publishable-api-key/{pka_id}' \ --header 'Authorization: Bearer {api_token}' \ --header 'Content-Type: application/json' \ --data-raw '{ - "title": "updated title" + "title": "new title" }' security: - api_token: [] diff --git a/docs/api/admin-spec3.yaml b/docs/api/admin-spec3.yaml index b3a3a5a979..3a591aca54 100644 --- a/docs/api/admin-spec3.yaml +++ b/docs/api/admin-spec3.yaml @@ -12314,7 +12314,7 @@ paths: // must be previously logged in or use api token - medusa.admin.publishableApiKeys.addSalesChannels(publishableApiKeyId, + medusa.admin.publishableApiKeys.addSalesChannelsBatch(publishableApiKeyId, { sales_channel_ids: [ { @@ -12330,7 +12330,7 @@ paths: label: cURL source: > curl --location --request POST - 'https://medusa-url.com/admin/publishable-api-keys/afasf/batch' \ + 'https://medusa-url.com/admin/publishable-api-keys/{pak_id}/batch' \ --header 'Authorization: Bearer {api_token}' \ @@ -12398,7 +12398,7 @@ paths: // must be previously logged in or use api token - medusa.admin.publishableApiKeys.removeSalesChannels(publishableApiKeyId, + medusa.admin.publishableApiKeys.deleteSalesChannelsBatch(publishableApiKeyId, { sales_channel_ids: [ { @@ -12414,7 +12414,7 @@ paths: label: cURL source: > curl --location --request DELETE - 'https://medusa-url.com/admin/publishable-api-keys/afasf/batch' \ + 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}/batch' \ --header 'Authorization: Bearer {api_token}' \ @@ -12475,19 +12475,26 @@ paths: // must be previously logged in or use api token - medusa.admin.publishableApiKey.create() - .then(({ publishable_api_key }) => { - console.log(publishable_api_key.id) - }) + medusa.admin.publishableApiKeys.create({ + title + }) + + .then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) + }) - lang: Shell label: cURL source: > curl --location --request POST 'https://medusa-url.com/admin/publishable-api-keys' \ - --header 'Authorization: Bearer {api_token}' + --header 'Authorization: Bearer {api_token}' \ - -d '{ "created_by": "user_123" }' + --header 'Content-Type: application/json' \ + + --data-raw '{ + "title": "Web API Key" + }' security: - api_token: [] - cookie_auth: [] @@ -12560,7 +12567,7 @@ paths: // must be previously logged in or use api token medusa.admin.publishableApiKeys.list() - .then(({ publishable_api_keys }) => { + .then(({ publishable_api_keys, count, limit, offset }) => { console.log(publishable_api_keys) }) - lang: Shell @@ -12622,15 +12629,16 @@ paths: // must be previously logged in or use api token - medusa.admin.publishableApiKey.delete(key_id) - .then(({ id, object, deleted }) => { - console.log(id) - }) + medusa.admin.publishableApiKeys.delete(publishableApiKeyId) + + .then(({ id, object, deleted }) => { + console.log(id) + }) - lang: Shell label: cURL source: > curl --location --request DELETE - 'https://medusa-url.com/admin/publishable-api-key/{id}' \ + 'https://medusa-url.com/admin/publishable-api-key/{pka_id}' \ --header 'Authorization: Bearer {api_token}' security: @@ -12682,19 +12690,18 @@ paths: // must be previously logged in or use api token - medusa.admin.publishableApiKey.retrieve(pubKeyId) - .then(({ publishable_api_key }) => { - console.log(publishable_api_key.id) - }) + medusa.admin.publishableApiKeys.retrieve(publishableApiKeyId) + + .then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) + }) - lang: Shell label: cURL source: > curl --location --request GET - 'https://medusa-url.com/admin/publishable-api-keys/pubkey_123' \ + 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}' \ --header 'Authorization: Bearer {api_token}' - - -d '{ "created_by": "user_123" }' security: - api_token: [] - cookie_auth: [] @@ -12752,14 +12759,14 @@ paths: // must be previously logged in or use api token medusa.admin.publishableApiKeys.listSalesChannels() - .then(({ sales_channels, limit, offset, count }) => { - console.log(sales_channels) + .then(({ sales_channels }) => { + console.log(sales_channels.length) }) - lang: Shell label: cURL source: > curl --location --request GET - 'https://medusa-url.com/admin/publishable-api-keys/pk_123/sales-channels' + 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}/sales-channels' \ --header 'Authorization: Bearer {api_token}' @@ -12815,7 +12822,7 @@ paths: // must be previously logged in or use api token - medusa.admin.publishableApiKey.revoke() + medusa.admin.publishableApiKeys.revoke(publishableApiKeyId) .then(({ publishable_api_key }) => { console.log(publishable_api_key.id) }) @@ -12823,12 +12830,10 @@ paths: label: cURL source: > curl --location --request POST - 'https://medusa-url.com/admin/publishable-api-keys/pubkey_123/revoke' + 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}/revoke' \ --header 'Authorization: Bearer {api_token}' - - -d '{ "created_by": "user_123", "revoked_by": "user_123" }' security: - api_token: [] - cookie_auth: [] @@ -12886,24 +12891,25 @@ paths: // must be previously logged in or use api token - medusa.admin.publishableApiKey.update(publishable_key_id, { + medusa.admin.publishableApiKeys.update(publishableApiKeyId, { title: "new title" }) - .then(({ publishable_api_key }) => { - console.log(publishable_api_key.id) - }) + + .then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) + }) - lang: Shell label: cURL source: > curl --location --request POST - 'https://medusa-url.com/admin/publishable-api-key/{id}' \ + 'https://medusa-url.com/admin/publishable-api-key/{pka_id}' \ --header 'Authorization: Bearer {api_token}' \ --header 'Content-Type: application/json' \ --data-raw '{ - "title": "updated title" + "title": "new title" }' security: - api_token: [] diff --git a/docs/api/admin/code_samples/JavaScript/publishable-api-key_{id}/postundefined b/docs/api/admin/code_samples/JavaScript/publishable-api-key_{id}/postundefined index 5559f00ea4..5b9e46f3d4 100644 --- a/docs/api/admin/code_samples/JavaScript/publishable-api-key_{id}/postundefined +++ b/docs/api/admin/code_samples/JavaScript/publishable-api-key_{id}/postundefined @@ -1,9 +1,9 @@ import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token -medusa.admin.publishableApiKey.update(publishable_key_id, { +medusa.admin.publishableApiKeys.update(publishableApiKeyId, { title: "new title" }) - .then(({ publishable_api_key }) => { - console.log(publishable_api_key.id) - }) +.then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) +}) diff --git a/docs/api/admin/code_samples/JavaScript/publishable-api-keys/getundefined b/docs/api/admin/code_samples/JavaScript/publishable-api-keys/getundefined index 893936cf51..0aed124df5 100644 --- a/docs/api/admin/code_samples/JavaScript/publishable-api-keys/getundefined +++ b/docs/api/admin/code_samples/JavaScript/publishable-api-keys/getundefined @@ -2,6 +2,6 @@ import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token medusa.admin.publishableApiKeys.list() - .then(({ publishable_api_keys }) => { + .then(({ publishable_api_keys, count, limit, offset }) => { console.log(publishable_api_keys) }) diff --git a/docs/api/admin/code_samples/JavaScript/publishable-api-keys/postundefined b/docs/api/admin/code_samples/JavaScript/publishable-api-keys/postundefined index 7daeb2fc03..2e83cfc321 100644 --- a/docs/api/admin/code_samples/JavaScript/publishable-api-keys/postundefined +++ b/docs/api/admin/code_samples/JavaScript/publishable-api-keys/postundefined @@ -1,7 +1,9 @@ import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token -medusa.admin.publishableApiKey.create() - .then(({ publishable_api_key }) => { - console.log(publishable_api_key.id) - }) +medusa.admin.publishableApiKeys.create({ + title +}) +.then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) +}) diff --git a/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}/deleteundefined b/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}/deleteundefined index 1b290cbee8..0da44544f5 100644 --- a/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}/deleteundefined +++ b/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}/deleteundefined @@ -1,7 +1,7 @@ import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token -medusa.admin.publishableApiKey.delete(key_id) - .then(({ id, object, deleted }) => { - console.log(id) - }) +medusa.admin.publishableApiKeys.delete(publishableApiKeyId) +.then(({ id, object, deleted }) => { + console.log(id) +}) diff --git a/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}/getundefined b/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}/getundefined index 875ac03a4b..a49f6d1a5b 100644 --- a/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}/getundefined +++ b/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}/getundefined @@ -1,7 +1,7 @@ import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token -medusa.admin.publishableApiKey.retrieve(pubKeyId) - .then(({ publishable_api_key }) => { - console.log(publishable_api_key.id) - }) +medusa.admin.publishableApiKeys.retrieve(publishableApiKeyId) +.then(({ publishable_api_key }) => { + console.log(publishable_api_key.id) +}) diff --git a/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_revoke/postundefined b/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_revoke/postundefined index f3bd1513b7..3705a7e41d 100644 --- a/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_revoke/postundefined +++ b/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_revoke/postundefined @@ -1,7 +1,7 @@ import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token -medusa.admin.publishableApiKey.revoke() +medusa.admin.publishableApiKeys.revoke(publishableApiKeyId) .then(({ publishable_api_key }) => { console.log(publishable_api_key.id) }) diff --git a/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_sales-channels/getundefined b/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_sales-channels/getundefined index b7039a418b..df67996f8d 100644 --- a/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_sales-channels/getundefined +++ b/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_sales-channels/getundefined @@ -2,6 +2,6 @@ import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token medusa.admin.publishableApiKeys.listSalesChannels() - .then(({ sales_channels, limit, offset, count }) => { - console.log(sales_channels) + .then(({ sales_channels }) => { + console.log(sales_channels.length) }) diff --git a/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_sales-channels_batch/deleteundefined b/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_sales-channels_batch/deleteundefined index 84e874b3a2..e4e422b731 100644 --- a/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_sales-channels_batch/deleteundefined +++ b/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_sales-channels_batch/deleteundefined @@ -1,7 +1,7 @@ import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token -medusa.admin.publishableApiKeys.removeSalesChannels(publishableApiKeyId, { +medusa.admin.publishableApiKeys.deleteSalesChannelsBatch(publishableApiKeyId, { sales_channel_ids: [ { id: channel_id diff --git a/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_sales-channels_batch/postundefined b/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_sales-channels_batch/postundefined index a74d1ede9f..1c882fcc81 100644 --- a/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_sales-channels_batch/postundefined +++ b/docs/api/admin/code_samples/JavaScript/publishable-api-keys_{id}_sales-channels_batch/postundefined @@ -1,7 +1,7 @@ import Medusa from "@medusajs/medusa-js" const medusa = new Medusa({ baseUrl: MEDUSA_BACKEND_URL, maxRetries: 3 }) // must be previously logged in or use api token -medusa.admin.publishableApiKeys.addSalesChannels(publishableApiKeyId, { +medusa.admin.publishableApiKeys.addSalesChannelsBatch(publishableApiKeyId, { sales_channel_ids: [ { id: channel_id diff --git a/docs/api/admin/code_samples/Shell/publishable-api-key_{id}/postundefined b/docs/api/admin/code_samples/Shell/publishable-api-key_{id}/postundefined index c52824266e..d215a07397 100644 --- a/docs/api/admin/code_samples/Shell/publishable-api-key_{id}/postundefined +++ b/docs/api/admin/code_samples/Shell/publishable-api-key_{id}/postundefined @@ -1,6 +1,6 @@ -curl --location --request POST 'https://medusa-url.com/admin/publishable-api-key/{id}' \ +curl --location --request POST 'https://medusa-url.com/admin/publishable-api-key/{pka_id}' \ --header 'Authorization: Bearer {api_token}' \ --header 'Content-Type: application/json' \ --data-raw '{ - "title": "updated title" + "title": "new title" }' diff --git a/docs/api/admin/code_samples/Shell/publishable-api-keys/postundefined b/docs/api/admin/code_samples/Shell/publishable-api-keys/postundefined index 87b05f49be..d76c693a80 100644 --- a/docs/api/admin/code_samples/Shell/publishable-api-keys/postundefined +++ b/docs/api/admin/code_samples/Shell/publishable-api-keys/postundefined @@ -1,3 +1,6 @@ curl --location --request POST 'https://medusa-url.com/admin/publishable-api-keys' \ ---header 'Authorization: Bearer {api_token}' --d '{ "created_by": "user_123" }' +--header 'Authorization: Bearer {api_token}' \ +--header 'Content-Type: application/json' \ +--data-raw '{ + "title": "Web API Key" +}' diff --git a/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}/deleteundefined b/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}/deleteundefined index 41922603be..2d06576df9 100644 --- a/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}/deleteundefined +++ b/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}/deleteundefined @@ -1,2 +1,2 @@ -curl --location --request DELETE 'https://medusa-url.com/admin/publishable-api-key/{id}' \ +curl --location --request DELETE 'https://medusa-url.com/admin/publishable-api-key/{pka_id}' \ --header 'Authorization: Bearer {api_token}' diff --git a/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}/getundefined b/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}/getundefined index 3a3f1a00ed..7eebfe5c87 100644 --- a/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}/getundefined +++ b/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}/getundefined @@ -1,3 +1,2 @@ -curl --location --request GET 'https://medusa-url.com/admin/publishable-api-keys/pubkey_123' \ +curl --location --request GET 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}' \ --header 'Authorization: Bearer {api_token}' --d '{ "created_by": "user_123" }' diff --git a/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_revoke/postundefined b/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_revoke/postundefined index f742a92ad3..6c3c1731a0 100644 --- a/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_revoke/postundefined +++ b/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_revoke/postundefined @@ -1,3 +1,2 @@ -curl --location --request POST 'https://medusa-url.com/admin/publishable-api-keys/pubkey_123/revoke' \ +curl --location --request POST 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}/revoke' \ --header 'Authorization: Bearer {api_token}' --d '{ "created_by": "user_123", "revoked_by": "user_123" }' diff --git a/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_sales-channels/getundefined b/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_sales-channels/getundefined index f3845038b6..9b1a9ec8f3 100644 --- a/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_sales-channels/getundefined +++ b/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_sales-channels/getundefined @@ -1,2 +1,2 @@ -curl --location --request GET 'https://medusa-url.com/admin/publishable-api-keys/pk_123/sales-channels' \ +curl --location --request GET 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}/sales-channels' \ --header 'Authorization: Bearer {api_token}' diff --git a/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_sales-channels_batch/deleteundefined b/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_sales-channels_batch/deleteundefined index 390c392a78..464937929e 100644 --- a/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_sales-channels_batch/deleteundefined +++ b/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_sales-channels_batch/deleteundefined @@ -1,4 +1,4 @@ -curl --location --request DELETE 'https://medusa-url.com/admin/publishable-api-keys/afasf/batch' \ +curl --location --request DELETE 'https://medusa-url.com/admin/publishable-api-keys/{pka_id}/batch' \ --header 'Authorization: Bearer {api_token}' \ --header 'Content-Type: application/json' \ --data-raw '{ diff --git a/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_sales-channels_batch/postundefined b/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_sales-channels_batch/postundefined index 6c7fc9369f..328abe74a6 100644 --- a/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_sales-channels_batch/postundefined +++ b/docs/api/admin/code_samples/Shell/publishable-api-keys_{id}_sales-channels_batch/postundefined @@ -1,4 +1,4 @@ -curl --location --request POST 'https://medusa-url.com/admin/publishable-api-keys/afasf/batch' \ +curl --location --request POST 'https://medusa-url.com/admin/publishable-api-keys/{pak_id}/batch' \ --header 'Authorization: Bearer {api_token}' \ --header 'Content-Type: application/json' \ --data-raw '{