GLPI
27 min
this connector integrates glpi project with turbine prerequisites the glpi asset requires either host, ip address, app token along with username and password or user token the glpi project allows connections only from whitelisted ip addresses please contact your glpi administrator to add your ip address to the whitelist capabilities the glpi connector provides the following capabilities add item delete item search items update item upload document notes api reference https //github com/glpi project/glpi configurations api key authentication authenticates using an api key configuration parameters parameter description type required url a url to the target host string required x apikey user token string required app token app token string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional http basic authentication authenticates using username and password configuration parameters parameter description type required url a url to the target host string required username username string required password password string required app token app token string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions add item add an object (or multiple objects) into glpi endpoint url apirest php/{{itemtype}} method post input argument name type required description path parameters itemtype string required parameters for the add item action input array optional input data for the action input name string optional input data for the action input serial string optional input data for the action input example {"json body" {"input" \[{"name" "my first computer","serial" "12345"},{"name" "my 2nd computer","serial" "67890"},{"name" "my 3rd computer","serial" "qsd12sd"}]},"path parameters" {"itemtype" "computer"}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {},"reason" "ok","json body" \[{"id" 8,"message" ""},{"id"\ false,"message" "you don't have permission to perform this action "},{"id" 9,"message" ""}]} delete item delete an object existing in glpi endpoint url apirest php/{{itemtype}}/{{id}} method delete input argument name type required description path parameters itemtype string required parameters for the delete item action input array optional input data for the action input id number required input data for the action force purge boolean optional parameter for delete item history boolean optional parameter for delete item input example {"json body" {"input" \[{"id" 16},{"id" 17}],"force purge"\ false,"history"\ false},"path parameters" {"itemtype" "computer"}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {},"reason" "ok","json body" \[{"16"\ true,"message" ""},{"17"\ false,"message" "item not found"}]} search items expose the glpi searchengine and combine criteria to retrieve a list of elements of specified itemtype endpoint url apirest php/search/{{itemtype}} method get input argument name type required description path parameters itemtype string required parameters for the search items action parameters criteria array required parameters for the search items action parameters criteria field number optional parameters for the search items action parameters criteria searchtype string optional parameters for the search items action parameters criteria value string optional parameters for the search items action parameters criteria link string optional parameters for the search items action parameters criteria meta boolean optional parameters for the search items action parameters criteria itemtype string optional parameters for the search items action parameters sort string optional parameters for the search items action parameters range string optional parameters for the search items action parameters order string optional parameters for the search items action parameters forcedisplay array optional parameters for the search items action parameters rawdata boolean optional parameters for the search items action parameters withindexes boolean optional parameters for the search items action parameters uid cols boolean optional parameters for the search items action parameters giveitems boolean optional parameters for the search items action input example {"parameters" {"criteria" \[{"field" 1,"searchtype" "contains","value" "","link" "and","meta"\ true,"itemtype" "user"},{"field" 1,"searchtype" "contains","value" "","link" "and","meta"\ true,"itemtype" "user"}],"sort" "1","range" "0 49","order" "asc","forcedisplay" \[""],"rawdata"\ false,"withindexes"\ false,"uid cols"\ false,"giveitems"\ false},"path parameters" {"itemtype" "monitor"}} output parameter type description status code number http status code of the response reason string response reason phrase totalcount number count value count number count value data object response data data 7 object response data data 7 1 string response data data 7 23 string response data data 7 80 string response data data 11 object response data data 11 1 string response data data 11 23 string response data data 11 80 string response data output example {"status code" 200,"response headers" {"accept range" "990","content range" "0 2/2"},"reason" "ok","json body" {"totalcount" 2,"count" 2,"data" {"7" {},"11" {}}}} update item update an object (or multiple objects) existing in glpi endpoint url apirest php/{{itemtype}}/{{id}} method put input argument name type required description path parameters itemtype string required parameters for the update item action path parameters id string required parameters for the update item action input array optional input data for the action input id number optional input data for the action input otherserial string optional input data for the action input example {"json body" {"input" \[{"id" 16,"otherserial" "abcde"},{"id" 17,"otherserial" "fghij"}]},"path parameters" {"itemtype" "computer","id" "10"}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {},"reason" "ok","json body" \[{"8"\ true,"message" ""},{"2"\ false,"message" "item not found"}]} upload document upload a file to glpi endpoint url apirest php/document method post input argument name type required description form data object required response data form data file object required binary file that you want to submit form data file file string required response data form data file file name string required response data data body object optional response data data body uploadmanifest string required response data input example {"form data" {"file" {"file" "string","file name" "example name"}},"data body" {"uploadmanifest" {"input" {"name" ""}}}} output parameter type description status code number http status code of the response reason string response reason phrase id number unique identifier message string response message upload result object result of the operation output example {"status code" 200,"response headers" {},"reason" "ok","json body" {"id" 1,"message" "document move succeeded ","upload result" {}}} response headers header description example accept range http response header accept range 990 content range http response header content range 0 2/2