Software Asset Mapping

Map software assets in Technopedia by using the following endpoints:

  • POST https://data.technopedia.com/mapping/software
    Use this endpoint for a single asset request only.

  • POST https://data.technopedia.com/mapping/batch/software
    Use this endpoint to make a single or batch request for 1 – 5000 assets.

Mapping a software asset

The software asset mapping endpoint accepts software asset data in a JSON object and maps that data to an entity in Technopedia, which is returned as a Technopedia ID when a match is found.
Technopedia IDs are returned for edition, product, release, and version of the software asset when software asset data is matched in Technopedia.

To submit a single asset request, the JSON object must be submitted in the body of an HTTP POST request to the /mapping/software endpoint. The following example shows the format that you must use to submit the data in the body of the POST request:
POST https://data.technopedia.com/mapping/software

{
   "title": "<value>",
   "version": "<value>",
   "manufacturer": "<value>"
}
   

The following example shows an HTTP POST request in Postman for a JSON object that has the title: "Microsoft SQL Server Enterprise Edition".
Technopedia IDs are returned for edition, product, release, and version that are associated with the Microsoft SQL Server Enterprise Edition product.
Figure 1. HTTP POST request in Postman

Take each Technopedia ID that is returned and use the TID Endpoint to get detailed asset data from Technopedia.
GET https://data.technopedia.com/technopedia-id/<technopedia-id>
GET https://data.technopedia.com/technopedia-id/e4238219-3ab4-4456-a8d7-dc98ff1f6116

Important!

All the fields in the JSON object that are submitted in the POST request must be matched in Technopedia before a Technopedia ID is returned.

Note:

The mapping/batch/software endpoint accepts single and batch requests.

Mapping a single asset example

The following examples show a single asset request to https://data.technopedia.com/mapping/software

POST https://data.technopedia.com/mapping/software

Request Body

{ 
    "title": "Microsoft SQL Server Enterprise Edition",
    "version": "2015.130.4199.0",
    "manufacturer": "Microsoft"
}

RESPONSE
[
    [
        {
            "class": "software",
            "technopedia_id": "9811058a-cd36-45de-a062-7921d5b1b4d2",
            "type": "edition"
        },
        {
            "class": "software",
            "technopedia_id": "34ccd904-e185-46eb-97e5-51951d30589b",
            "type": "product"
        },
        {
            "class": "software",
            "technopedia_id": "25157b56-f6e4-4fd4-8009-f70c9135065e",
            "type": "release"
        },
        {
            "class": "software",
            "technopedia_id": "224f83d2-7087-470c-af3b-e40f7248ef66",
            "type": "version"
        }
    ]
]
curl -X POST \
  https://data.technopedia.com/mapping/software \
  -H 'Authorization: Bearer 3111d6aa-410f-4fb5-9693-32323d5c1c04' \
  -H 'Content-Type: application/json' \
  -H 'Postman-Token: 7fb01252-a1d5-4eae-8786-ada95946c74f' \
  -H 'cache-control: no-cache' \
  -d '{ 
    "title": "Microsoft SQL Server Enterprise Edition",
    "version": "2015.130.4199.0",
    "manufacturer": "Microsoft"
}

RESPONSE

[
    [
        {
            "class": "software",
            "technopedia_id": "9811058a-cd36-45de-a062-7921d5b1b4d2",
            "type": "edition"
        },
        {
            "class": "software",
            "technopedia_id": "34ccd904-e185-46eb-97e5-51951d30589b",
            "type": "product"
        },
        {
            "class": "software",
            "technopedia_id": "25157b56-f6e4-4fd4-8009-f70c9135065e",
            "type": "release"
        },
        {
            "class": "software",
            "technopedia_id": "224f83d2-7087-470c-af3b-e40f7248ef66",
            "type": "version"
        }
    ]
]

Mapping single or multiple software assets

Submit single or multiple assets in an HTTP POST request to the /mapping/batch/software endpoint. The JSON objects must be submitted in the body of an HTTP POST request.
The following example shows the format that you must use to submit the data.
POST https://data.technopedia.com/mapping/batch/software

[
  {
   "title": "<value>",
   "version": "<value>",
   "manufacturer": "<value>"
  }
]
[
  {
   "title": "<value>",
   "version": "<value>",
   "manufacturer": "<value>"
  },
  {
   "title": "<value>",
   "version": "<value>",
   "manufacturer": "<value>"
  }
]

The following example shows an HTTP POST request in Postman for a JSON object that has the titles: "Microsoft SQL Server Enterprise Edition" and "Microsoft SQL Server Database Engine 13.0".
Technopedia IDs are returned for edition, product, release, and version when the data is matched in Technopedia.
Figure 2. HTTP POST request in Postman

Examples of single and multiple assets requests

POST https://data.technopedia.com/mapping/batch/software

Request Body for a single asset request
[    
     {
        "title": "Microsoft SQL Server Enterprise Edition",
        "version": "2015.130.4199.0",
        "manufacturer": "Microsoft"
     }
]


RESPONSE

[
    [
        {
            "class": "software",
            "technopedia_id": "9811058a-cd36-45de-a062-7921d5b1b4d2",
            "type": "edition"
        },
        {
            "class": "software",
            "technopedia_id": "34ccd904-e185-46eb-97e5-51951d30589b",
            "type": "product"
        },
        {
            "class": "software",
            "technopedia_id": "25157b56-f6e4-4fd4-8009-f70c9135065e",
            "type": "release"
        },
        {
            "class": "software",
            "technopedia_id": "224f83d2-7087-470c-af3b-e40f7248ef66",
            "type": "version"
        }
    ]
]
POST https://data.technopedia.com/mapping/batch/software

Request Body for two assets
[    
     {
        "title": "Microsoft SQL Server Enterprise Edition",
        "version": "2015.130.4199.0",
        "manufacturer": "Microsoft"
    },
    {      
        "title": "Microsoft SQL Server Database Engine 13.0",
        "version": "13.0",
        "manufacturer": "Microsoft"
    }
]


RESPONSE

[
    [
        {
            "class": "software",
            "technopedia_id": "9811058a-cd36-45de-a062-7921d5b1b4d2",
            "type": "edition"
        },
        {
            "class": "software",
            "technopedia_id": "34ccd904-e185-46eb-97e5-51951d30589b",
            "type": "product"
        },
        {
            "class": "software",
            "technopedia_id": "25157b56-f6e4-4fd4-8009-f70c9135065e",
            "type": "release"
        },
        {
            "class": "software",
            "technopedia_id": "224f83d2-7087-470c-af3b-e40f7248ef66",
            "type": "version"
        }
    ],
    [
        {
            "class": "software",
            "technopedia_id": "",
            "type": "edition"
        },
        {
            "class": "software",
            "technopedia_id": "b634739c-fc6d-435b-a77e-d459bca1889c",
            "type": "product"
        },
        {
            "class": "software",
            "technopedia_id": "5850f5c7-5205-4da3-b21f-4e904a20882c",
            "type": "release"
        },
        {
            "class": "software",
            "technopedia_id": "a624ee86-09e5-4410-a882-acfe72612879",
            "type": "version"
        }
    ]
]

Software Asset Mapping


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.