To interact with the Platform APIs, you'll need a valid access-token. Depending upon your use case, you can obtain an access-token in the following ways:

1. To develop an extension: You need to implement OAuth in order to get access-token for the companies that install your extension. Refer to this guide on implementing OAuth in extension.
2. To integrate a company on the Fynd Commerce with external systems: You can generate an access-token for the required company using the client credentials of that company. Refer to Getting Access-token using Client Credentials for the steps.

Prerequisites

• Ensure that you have registered on the Fynd Commerce and have access to the company.

You can obtain your client credentials from Fynd Commerce. Follow the steps below to retrieve the credentials from a company:

1. Log in to your Fynd Commerce account.
2. If you have access to multiple companies, you will get the option to select a company.
3. Select the company from the list andit will open the Fynd Commerce page.
4. In the sidebar, navigate to Company → Settings → Developers tab and click Clients.
   - If client credentials are available, go to Create an access-token using client credentials.
   - If no client credentials are available, click Create Client and fill in the required details. You will get a success notification when client's credentials are created.

To make a Platform API call, you will need a valid access-token. Access-tokens are generated using your client credentials. To obtain an access-token, you should construct a POST request to the /oauth/token endpoint. Please include the parameters specified below in the request body:

1. Run the following command to convert client credentials to base64TokenString:

   1base64TokenString=$(echo -n <client_id>:<client_secret> | base64)
2. Run the following command to view the base64TokenString and save it for later use:

   1echo $base64TokenString
3. Use the following cURL to generate the access-token:

   1curl -X POST "https://api.fynd.com/service/panel/authentication/v1.0/company/{company_id}/oauth/token" \
   2-H "Authorization: Basic <base64TokenString>" \
   3-H 'Content-Type: application/json' \
   4-d '{"grant_type":"client_credentials"}'
   • grant_type: Pass it as client_credentials to get access-token.
   Response

   Upon a successful request, the server will respond with an access-token as shown below:

   1{
   2  "access_token": oa-12345fb123456b2ce111f43cdb55fd317def1234,
   3  "token_type": "Bearer",
   4  "expires_in": 3599,
   5  "expires_at": 1759834568.805,
   6  "scope": ["company/*", "company/application/*"]
   7}
4. To make authenticated requests to Platform APIs, pass the access-token (received in response) in the authorization header:

   1Authorization: Bearer <access_token>

In the below given example, we can retrieve a list of products available in a company using the getProducts API. You need to pass the company ID and authorization token to make the API call.

1curl -X GET "https://api.fynd.com/service/platform/catalog/v2.0/company/{company_id}/products/" \
2-H 'Authorization: Bearer {access_token}'