The Flextory API allows you to query and manipulate items via simple url calls. The API can be used to integrate the data you have in Flextory with other applications and scripts. Some examples of how the Flextory API could be useful are as follows:

• Have your DNS server only allow machines that are listed in your Flextory account
• Import data from another database or source
• Export data to another source
• Create new interfaces/software to manipulate data you have listed in Flextory
• Automatically add data to your Flextory account based on events in your custom software
• Whatever else you can imagine

Your use of the Flextory API is limited by the plan in which you are subscribed to and the terms listed in the Service Agreement. Excessive or abusive usage of the Flextory API may result in warnings and or suspension of your account. If you have concerns about your particular use of the API, please contact support@flextory.com.

• Your Flextory Private Key
  • A private key is automatically generated for each new Flextory user. Click on your name (User Profile) while logged into Flextory to retrieve your private key.
• A Language with an implementation of HMAC with support for SHA512

You'll first have to build a query string. For example, the following query string finds all items that have the Item Type, 'Desktop':

userName=api&search=true&itemType=Desktop

You then have to use the HMAC method on your query string to generate your public key for this request. In PHP, you would do the following:

$publicKey = hash_hmac('sha512', 'userName=api&search=true&itemType=Desktop', '[Private Key Here]');

You then need to add your public key to the end of your query string like so:

userName=api&search=true&itemType=Desktop&publicKey=$publicKey

Finally, you can put the entire url together like so:

http://home.codingbychris.com:82/inventory/inventory/dataHandlers/api.php?userName=api&search=true&itemType=Desktop&publicKey=$publicKey

Make use of https: instead of http: to use a secure connection if your language supports it. Consult your language's documentation on how to configure and use https.

The server will then return a JSON object. If the 'success' variable is true, then the query was successful. An example response can be seen below.

{
  "items": [
    {
      "assetType": "Desktop", 
      "attributes": {
        "OS": "Windows", 
        "IP": "192.168.1.232", 
        "End User": "Fred", 
      }, 
      "barcode": "4334433434", 
      "dateAdded": "2012-03-09 10:28:29", 
      "dateModified": "2012-03-09 10:28:29", 
      "id": 29, 
      "name": "Glados"
    }, 
    {
      "assetType": "Desktop", 
      "attributes": {
        "OS": "Linux", 
        "IP": "192.168.1.222", 
        "End User": "Chris", 
      }, 
      "barcode": "34453344", 
      "dateAdded": "2012-03-09 10:29:27", 
      "dateModified": "2012-03-09 10:29:27", 
      "id": 34, 
      "name": "Pixie"
    }
  ], 
  "success": "true"
}