# Configuration

# Creating API Credentials

UnoPim allows you to generate API credentials that control access to the platform through integrations. The process includes setting up API keys, configuring permissions, assigning users, and generating secret keys.

# Steps to Create API Credentials

  1. Navigate to the Integrations Tab:
    • Go to Configuration -> Integrations in the UnoPim admin panel.

configuration

  1. Click on Create:

    • Under the API Keys section, click the Create button to start the process of creating a new API key.
  2. General Section:

    • In the General Section, provide the following details:
      • Name: Enter a unique name for the API key.
      • Assign User: Choose the user who will be assigned to this API key.

    configuration

  3. Access Control:

    • Navigate to the Access Control Section, where you'll configure permissions for the API key.

    • Permissions Field: You’ll see two options for setting permissions:

      1. All: Grants full access to the API key across all features.
      2. Custom: Allows you to define specific permissions.

      If you select Custom, the following options will appear:

      • Settings Permissions: Use checkboxes to select which settings the API key can access.
      • Catalog Permissions: Similarly, choose catalog-related permissions using checkboxes.
  4. Save and Activate:

    • After filling out the necessary details and selecting permissions, click Save to generate the API credentials.

    configuration

  5. Generate Secret Key:

    • Once saved, a Generate Secret Key button will appear.
    • Click on this button to display the Client ID and Secret Key.
    • These credentials will be used to access UnoPim's APIs.

    configuration configuration

Note : Re-Generate Secret Key:

  • After generating the secret key, a Re-Generate Secret Key button will be available.
  • Use this button to regenerate the secret key if needed.

Create API Credentials User Guide

For more detailed reference, you can consult the UnoPim User Guide here (opens new window).


# Set up Postman

UnoPim provides a Postman collection and environment to simplify API testing and exploration.

# Step by step

  1. Download Postman:

  2. Download the required files:

    Api Collection Export

    Api Environment Export

  3. Import into Postman:

    • Open Postman and use the Import button to add both the collection and environment files.
  4. Select Environment:

    • Once the environment is imported, select the UnoPim API environment from the environment dropdown menu.
    • Set the Environment variables, including the username, password, clientId, secret, and the URL of the application.

    Api Environment Variable

  5. Send a Request:

    • Now you can send your first request using the pre-configured Postman collection to interact with UnoPim APIs.