diff --git a/www/apps/api-reference/markdown/admin.mdx b/www/apps/api-reference/markdown/admin.mdx index e2eee7359eadd..eb8f3eb6b7dc1 100644 --- a/www/apps/api-reference/markdown/admin.mdx +++ b/www/apps/api-reference/markdown/admin.mdx @@ -133,7 +133,7 @@ Authorization: Bearer {jwt_token} ### 2. API Token -Use a user's API Token to send authenticated requests. +Use a user's secret API Token to send authenticated requests. @@ -145,7 +145,7 @@ Use a user's API Token to send authenticated requests. #### How to Create an API Token for a User -Use the [Create API Key API Route](#api-keys_postapikeys) to create an API token. +Create the API key token either from the Medusa Admin or using the [Create API Key API Route](#api-keys_postapikeys). @@ -180,16 +180,45 @@ curl -X POST 'localhost:9000/admin/api-keys' \ #### How to Use the API Token -Use the API token by passing it in a basic authorization header. +You pass the API Key token as a base64 token in the authorization header. For example, when sending a request in JavaScript: + + + +When using the JS SDK, you only need to specify the API key token in the [configurations](!resources!/js-sdk#js-sdk-configurations). The JS SDK will handle passing the token as expected. + + -```bash title="Use API token" -Authorization: Basic {api_key_token} + + + +```js +fetch(`{backend_url}/admin/products`, { + headers: { + Authorization: `Basic ${window.btoa(`:${api_key_token}`)}`, + }, +}) +``` + + + + +```js +fetch(`{backend_url}/admin/products`, { + headers: { + Authorization: `Basic ${ + Buffer.from(`:${api_key_token}`).toString("base64") + }`, + }, +}) ``` + + + diff --git a/www/apps/api-reference/markdown/client-libraries.mdx b/www/apps/api-reference/markdown/client-libraries.mdx index dae6acb7bbe22..b91086e821ca4 100644 --- a/www/apps/api-reference/markdown/client-libraries.mdx +++ b/www/apps/api-reference/markdown/client-libraries.mdx @@ -16,7 +16,7 @@ To use Medusa's JS SDK library, install the following packages in your project ( npm install @medusajs/js-sdk@latest @medusajs/types@latest ``` -Learn more about the JS SDK in [this documentation](!resources!/js-sdk). +Learn more about the JS SDK and how to configure it in [this documentation](!resources!/js-sdk). ### Download Full Reference