{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"22b8fbc0-02eb-4ceb-a901-e1563f01571b","name":"Trackinno Service API (alpha)","description":"This document describes the Trackinno Service API used by our desktop and mobile application. This API is meant to be used by browser clients & untrusted parties (using OAuth2.0) and by back-end servers & trusted parties (using API key).\n\n# Authorization\n\n## Basic Auth (API key)\n\nTrusted parties can access the API using HTTP Basic Auth with an API key. The API key is composed of base64-encoded client_id and client_secret.\n\n| Headers | Description |\n| --- | --- |\n| \"Authorization\": \"Basic API_KEY\" | Authentication |\n\nAPI-keys can only be used by trusted parties that are able to securely store it. The key should be kept on back-end servers and never given to front-end clients. Thus any front-end queries must be proxied through the back end. All requests should be made using HTTPS.\n\n## Access token\n\nUntrusted parties use JWT Access tokens provied by Auth0 (OIDC Identity Provider).\n\n```\nCOMING SOON\n\n ```\n\n# Authentication\n\nMost endpoints that are used to access data (e.g GET queries) require authorization, but do not require authentication. These endpoints can be called anonymously using the API key.  \nEndpoints that create or update data require both authorization (API key) and authentication. The `X-On-Behalf-Of` -header is used to indicate the user on behalf of the request is made.\n\n| Headers | Description |\n| --- | --- |\n| \"X-On-Behalf-Of\": \"user_id\" | Make request on behalf of user |\n\n# Terminology\n\n## Asset\n\nAssets are typically physical items like equipment, tools, machines that can be tracked using Trackinno Service. Assets are related to other information managed by Trackinno Service like Geolocation, Asset Models (Asset Types), Data Fields, Attachments, Usages and Orders.\n\n## Asset Model (Asset Type)\n\nAsset Models (Asset Types) can be used to share information of one Asset Model to all assets of that Model. In addition to storing shared information for Assets with the same Model, Asset Models can be used to get statistics about how different Asset Models are being used.\n\n## Location\n\nLocations are used to define physical or non-physical places within the users company where the Assets can be located. Locations can be managed with a hierarchical structure using Location Types. Every Location has one Location Type. In case Locations are used to describe projects or other periodically existing places, they may have start and end time.\n\n## Location Type\n\nLocation Types can be used to describe the structure of Locations within customers company. As an example a company might have ”Business Unit” as a top level Location Type and ”Warehouse” as a sub Type. With this setup Warehouses can be defined within business units which could be useful to filter all Assets within Warehouses of a specific Business unit.\n\n## Usage\n\nUsages are another key element within Trackinno Service. They are used to track how the Assets are used. Usages have information about the time period (start and end time), holder (= where the Asset is being used, User/Location) and Assets that are on the same Usage.\n\n## Field\n\nFields are dynamic data fields that can be configured by the user. They can be linked into Assets, Asset Models or Location Types. There are multiple different types of Fields, for example text input, textarea input, date, date&time, select list and user picker.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"4124128","team":101524,"collectionId":"22b8fbc0-02eb-4ceb-a901-e1563f01571b","publishedId":"RW87qVN1","public":true,"publicUrl":"https://api.trackinno.com","privateUrl":"https://go.postman.co/documentation/4124128-22b8fbc0-02eb-4ceb-a901-e1563f01571b","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"0399CB"},"documentationLayout":"classic-double-column","version":"8.11.6","publishDate":"2018-05-30T07:26:22.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"statusCode":200},"environments":[{"name":"service.trackinno.com","id":"6a3e9c2d-740f-4c38-8e0f-b6d5aa3c5da3","owner":"3403787","values":[{"key":"domain","value":"https://service.trackinno.com","enabled":true,"type":"text"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/ccf0e49f29e3286baa29626e6c67d039ce9aa0c1054fd143afef304d577ea215","favicon":"https://trackinno.com/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"service.trackinno.com","value":"3403787-6a3e9c2d-740f-4c38-8e0f-b6d5aa3c5da3"}],"canonicalUrl":"https://api.trackinno.com/view/metadata/RW87qVN1"}