Dealer Integration Type OData

Overview

The Dealer Integration Type OData API provides a way to retrieve active integration types from a particular Aimbase. With multiple filter and expand options, this API can tell you anything from a list of active integrations in an Aimbase instance, to required key (username, password etc) fields needed to pass leads to the correct dealer.  This document will go over how you can use the Dealer Integration Type OData for your specific needs.

This is an OData endpoint, and it will support the OData query language. More information about this can be found at odata.org

Possible Response Codes

  • 200 (OK). This request was successful and information will be returned.
  • 401 (Unauthorized). The token is missing or invalid.
  • 404 (Not Found). The dealer was not able to be found.
  • 500 (Internal Server Error). The request was malformed, the dealer given in the request did not exist, or some other unspecified error occurred when attempting to retrieve dealer integration type information.

Authentication

The Dealer Integration Type API requires authentication. The GET request will require a valid Authenticate message header with an API token. See the Aimbase Authentication Web Service Specification for more details on how to retrieve a valid API token. 

Authenticate message header example:

Authenticate: Avala-Api {username}:{token}

Query Information

Endpoint 

GET https://{baseurl}/odata/V2/DealerIntegrationTypes


Dealer Integration Type OData Data Schema 

The information below will be returned in a GET. All fields listed below can be applied as a filter. For filter formatting in OData, please reference this page and navigate to section 4.5. Filter System Query Option to see operators and examples.

Name

Editable

Values

Description

Id
Integer The Aimbase id of the Integration Type
Code
String The code for the integration type.
Name
UID The name of the integration type.
Description
Integer The description of the integration type.
IsActive
Integer If the integration type is active or not.
CreatedDate
YYYY-MM-dd ±hh:mm

The date the integration type was entered.

UpdateDate
YYYY-MM-dd ±hh:mm The date the integration type was updated.
CreateAccountId
Integer The id of the account that created the lead
UpdateAccountId
Integer The id of the account that created the lead

IsKeyRequired
Boolean The integration's requirement to pass a key value when sending leads.
IsUsernameRequired
Boolean

The integration's requirement to pass a username value when sending leads.

IsPasswordRequired
Boolean


The integration's requirement to pass a password value when sending leads.
IsClientIdRequired
Boolean


The integration's requirement to pass a ClientId value when sending leads.
IsClientSecretRequired
Boolean

The integration's requirement to pass a ClientSecret value when sending leads.
IsSendingDealerIntegrationOnReassign
Boolean If the OEM is using the lead reroute feature, and the lead is reassigned, the lead can still send to the reassigned dealer's CRM or not. 


Sample Queries

ALL

GET https://{baseurl}/Odata/V2/DealerIntegrationTypes


Get By ID

GET https://{baseurl}/Odata/V2/DealerIntegrationTypes(1)


Filter

GET https://{baseurl}/Odata/V2/DealerIntegrationTypes?$filter=Code eq '3 Clix HTTP/1.1


Example Response


  "value": [
    {
      "Id": 1,
      "Code": "(provider code)",
      "Name": "(provider name)",
      "Description": "(provider name) is a Dealer CRM",
      "IsActive": true,
      "CreateDate": "2015-06-15T18:28:52.273+05:30",
      "UpdateDate": "2015-08-31T17:25:04.19+05:30",
      "CreateAccountId": 0,
      "UpdateAccountId": 4,
      "IsKeyRequired": true,
      "IsUsernameRequired": false,
      "IsPasswordRequired": false,
      "IsClientIdRequired": false,
      "IsClientSecretRequired": false,
      "IsSendingDealerIntegrationOnReassign": false
    },