Medusa JS Client
The Medusa JS Client provides easy access to the Medusa API from a client written in TypeScript. This reference guides you to learn what methods the client has and how you can use them.
This client can be use as an alternative to directly interacting with the REST APIs.
Installation
To install the Medusa JS Client run the following command:
Usage
Import Medusa as a default import and initiate it:
How to Use this Reference
You'll find in the sidebar of this reference names of different resources. These resources are properties in the Medusa instance you initialize and you can access them directly using the instance. Then, you'll be able to access the methods or nested resources within those resources.
For example, to create a new customer you can access the create method under the customers property of your client:
The customers
resource also has another resource addresses
nested inside it with its own method that you can access similarly:
Authentication
Authentication can be achieved in two ways using the medusa-js
client: either by utilizing API keys or by using cookie based authentication. Each method has its own unique use case.
Using API keys
API keys can only be used for admin functionality in Medusa since only users of the admin system have API keys. Refer to the Configuration section to learn how to add the API key to requests.
You can follow this guide to learn how to create an API key for an admin user.
Using cookies
Authentication using cookies is done automatically by Axios, which is used within the Medusa JS Client, when authenticating using the auth endpoints. After authentication, all subsequent calls will be authenticated.
Configuration
Initialize with config object
The package can be initialized with several options:
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. You can create a publishable API key either using the admin APIs or the Medusa admin. |