[GET] - Installed Tech Data

  • Updated

Use the Installed Tech (technographics) List endpoint to fetch the list of technologies. 

Endpoint

GET - https://api.insideview.com/api/v1/reference/techProfile

Request

HTTP Headers

Header Name Type Required Description
accessToken String Yes

Valid access token.
See Authentication and Authorization Overview for more details.
Accept String No Selects the response's content type.  
Valid values are application/json and application/xml (default). 

Responses

Here are the major responses the API may return.

For details on the errors, see API Error Codes.

HTTP 200

Returns either a JSON or XML data structure depending on the request Accept header. 

Name type Description
categories Array Array of categories
categoriescategoryId String Category id
categoriescategoryName String Category Name
categoriessubCategories Array Array of Sub Categories
categoriessubCategoriessubCategoryId String Sub Category Id
categoriessubCategoriessubCategoryName String Sub category Name
categoriessubCategoriesproducts Array Array of products
categoriessubCategoriesproductsproductId String Product ID
categoriessubCategoriesproductsproductName String Product name

Type: application/json

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "id": "/",
  "type": "object",
  "properties": {
    "categories": {
      "id": "categories",
      "type": "array",
      "items": [
        {
          "id": "0",
          "type": "object",
          "properties": {
            "categoryId": {
              "id": "categoryId",
              "type": "string"
            },
            "categoryName": {
              "id": "categoryName",
              "type": "string"
            },
            "subCategories": {
              "id": "subCategories",
              "type": "array",
              "items": [
                {
                  "id": "0",
                  "type": "object",
                  "properties": {
                    "subCategoryId": {
                      "id": "subCategoryId",
                      "type": "string"
                    },
                    "subCategoryName": {
                      "id": "subCategoryName",
                      "type": "string"
                    },
                    "products": {
                      "id": "products",
                      "type": "array",
                      "items": [
                        {
                          "id": "0",
                          "type": "object",
                          "properties": {
                            "productId": {
                              "id": "productId",
                              "type": "string"
                            },
                            "productName": {
                              "id": "productName",
                              "type": "string"
                            }
                          }
                        }
                      ]
                    }
                  }
                }
              ]
            }
          }
        }
      ]
    }
  }
}

Example

{  
   "categories":[  
      {  
         "categoryId":"12",
         "categoryName":"Project Management",
         "subCategories":[  
            {  
               "subCategoryId":"1595695491",
               "subCategoryName":"Project Portfolio Management (PPM)",
               "products":[  
                  {  
                     "productId":"3093506260",
                     "productName":"Primavera Enterprise Project Portfolio Management"
                  },
                  {  
                     "productId":"3212249385",
                     "productName":"Planview"
                  }
               ]
            }
         ]
      }
   ]
}

Type: application/xml

Schema

<xs:schema attributeFormDefault="unqualified"
	elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
	<xs:element name="techProfile">
		<xs:complexType>
			<xs:sequence>
				<xs:element name="categories">
					<xs:complexType>
						<xs:sequence>
							<xs:element name="category" maxOccurs="unbounded"
								minOccurs="0">
								<xs:complexType>
									<xs:sequence>
										<xs:element type="xs:string" name="categoryId" />
										<xs:element type="xs:string" name="categoryName" />
										<xs:element name="subCategories">
											<xs:complexType>
												<xs:sequence>
													<xs:element name="subCategory" maxOccurs="unbounded"
														minOccurs="0">
														<xs:complexType>
															<xs:sequence>
																<xs:element name="products">
																	<xs:complexType>
																		<xs:sequence>
																			<xs:element name="product" maxOccurs="unbounded"
																				minOccurs="0">
																				<xs:complexType>
																					<xs:sequence>
																						<xs:element type="xs:string" name="productId" />
																						<xs:element type="xs:string" name="productName" />
																					</xs:sequence>
																				</xs:complexType>
																			</xs:element>
																		</xs:sequence>
																	</xs:complexType>
																</xs:element>
																<xs:element type="xs:string" name="subCategoryId" />
																<xs:element type="xs:string" name="subCategoryName" />
															</xs:sequence>
														</xs:complexType>
													</xs:element>
												</xs:sequence>
											</xs:complexType>
										</xs:element>
									</xs:sequence>
								</xs:complexType>
							</xs:element>
						</xs:sequence>
					</xs:complexType>
				</xs:element>
			</xs:sequence>
		</xs:complexType>
	</xs:element>
</xs:schema>

Example

<?xml version="1.0" encoding="UTF-8"?>
<techProfile>
   <categories>
      <category>
         <categoryId>12</categoryId>
         <categoryName>Project Management</categoryName>
         <subCategories>
            <subCategory>
               <products>
                  <product>
                     <productId>1469146308</productId>
                     <productName>VersionOne</productName>
                  </product>
                  <product>
                     <productId>707151835</productId>
                     <productName>Pivotal Tracker</productName>
                  </product>
               </products>
               <subCategoryId>3047556431</subCategoryId>
               <subCategoryName>Project Management</subCategoryName>
            </subCategory>
         </subCategories>
      </category>
   </categories>
</techProfile>

HTTP 400

Invalid query parameter(s).

HTTP 401

Unauthorized Error - Cannot use API's without setting a valid accessToken in header.

HTTP 405

Method Not Allowed - Your are not allowed to access this API.

HTTP 429

Request is throttled.

 

Was this article helpful?

0 out of 0 found this helpful