docs
Index
API Docs

Index API Documentation

Index is a cloud-based parameter storage that smoothly runs all your core lending operations. It is an accumulation of all your master setups, including asset catalog and inventory, programs, rates, and profiles for lenders, dealers and multiple partners, in one centralized location for all business types. Index can enhance delivery efficiency and program management for easy integration into all systems.

Index provides the following features:

  • Lender Configurations:

    Get access to core setups of the running order journey for dealers and partners. These setups manage everything from assets and integrations to the entire front-office, middle-office, and back-office journey.

  • Programs and Rates:

    Configure programs and rates for dealers, partners, and assets to enable risk-based and usage-based pricing models.

  • Dealer and Partner Management:

    Create and manage a network of dealerships and partners that fall under the lender.

  • Dealer Configurations:

    Make use of all dealer-level configurations, including the configuration of the profile, fee, and tags, options that can be used during the entire order journey.

  • Inventory Management:

    Upload and manage inventory units, including options association, price updates and marking listing availability for each unit.

For Complete Index API Documentation Click Here (opens in a new tab).

How to Connect

Index is a pure-play SaaS product with a secure RESTful API. The API can be consumed by invoking the methods available in the subscription using this OpenAPI documentation.

Pre-requisites

Before you can use Index, you must complete the following step:

  1. Register on Appex-Now Website (opens in a new tab).
  2. Purchase Index subscription or start for free using the available Trial subscription.

After completing the Prerequisites you can follow the following steps to connect with Index:

Step-1: Select Method

  1. After subscribing to Index, you will receive an email with the link to Index API documentation and the relevant API and the sandbox key. API key is used to call methods on live environment whereas sandbox key is used for testing purposes.

  2. Index API documentation consists of the following details.

    • Method
    • Endpoint Details
    • Request and Response Schemas
    • Authorization details
    • Example / Sample payloads
  3. Your API key is linked to your subscription and is required for calling any of the Index methods.

  4. Your Sandbox key is linked to your subscription as well but used for testing purposes.

  5. You can search for a specific method or keyword using the search control available on the top left column.

Step-2: Call Method

Run in Code

  1. After selecting a method, copy the endpoint URL from the right column of API documentation.

  2. Identify the RESTful API method e.g POST, GET, PUT, DELETE etc from endpoint URL.

  3. Click 'Run in Postman' which will open the Postman request of the respective method.

  4. Select the code snippet of your desired language from the right-side navigation of postman UI.

  5. Replace the API-key in the code snippet with the API-key provided in the Welcome email received when subscribing.

  6. You are required to include the API key header manually as shown below:

    >> x-api-key = [Your-API-Key]
  7. The request schema for the method is shown in the middle column and the request payload (example) is given in the right column.

  8. After providing the API key, request body and RESTful method with the endpoint details, you would be able to execute and receive a response.

Run in Postman

  1. The request can be executed within the Postman UI as well by forking the Index collection and updating the x-api-key header in the collection variables.

  2. Make sure to log-in to your Postman account before clicking the 'Run in Postman' button or login afterwards.

  3. Right click the Index Collection and click 'Create a Fork' or try to click the 'Send' request button, it should ask you to fork the collection.

  4. Postman's 'Create a Fork' screen will appear, before Forking the collection, please make sure to select 'Watch original collection' checkbox to enable 'Pull Changes' function to receive collection updates.

  5. After the Collection is forked/created in your Postman Workspace, please update the Collection variable(s) "x-api-key" and others based on the values/keys provided to you.

  6. All requests are configured to use their collection variables.

Step-3: Method Response

  1. Once you call the method, following are the possible types of responses statuses:

    1. 200 - Success
    2. 400 - Bad Request
    3. 401 - Authorization information is missing or invalid
    4. 422 - Validation Error
    5. 500 - Internal server error
  2. For each of the response statuses the response schemas are given in the method details.

  3. All responses are in JSON format

For Complete Index API Documentation Click Here (opens in a new tab).