Working with the Web API

about the web services api docid ozoh1ezv8cbamg2ho320creating a link to a request offering docid ozoh1ezv8cbamg2ho320about timeouts docid ozoh1ezv8cbamg2ho320cloud connect api methods docid ozoh1ezv8cbamg2ho320working with api keys docid ozoh1ezv8cbamg2ho320 about the web services api the web api module is a framework with sample methods that can be used to integrate external web applications with the self service portal and the service catalog developers can retrieve data from the database and publish navigation links to specific application pages it can also offer pass through authentication for external users this api is a self contained developer tool and includes instructions on how to load the web apis into the external application page, how to authenticate, and more creating a link to a request offering from the configuration console, click extend > web services api to go to the heat api workspace from the left pane, click searchofferings the application displays a list of available request offerings heat api click a service from the list a web page opens with the link in the url area for example https //heatsoftware com/?scope=selfservice \&commandid=new \&tab=servicecatalog \&template=ae3e70c3bbff470597ea1134fece464d \&frameless=false \&role=admin#1390514684377 remove the role from the link the remainder is what you can send to users as a link to the service offering about timeouts while making web service calls, note the following a microsoft sql timeout exception occurs when any query takes more than 60 seconds a request timeout occurs when the api call runs for more than 90 seconds in the application server cloud connect api methods the following methods have been added to the web api to enable the manipulation of service requests method description getcategories returns the list of available categories for the service catalog getcategorytemplates returns the list of request offerings in the service catalog, which belong to the indicated category getalltemplates returns the full list of request offerings in the service catalog getsubscriptionid fetches the subscription id that corresponds to the request offering for the current user getpackagedata retrieves the details of the indicated request offering usercanaccessrequestoffering checks whether the current user is entitled to access the request offering submitrequest creates and submits the service request, on behalf of a user getrequestdata retrieves the data for the service request fetchservicereqvalidationlistdata fetches the allowable validation list data for the service request parameter working with api keys about api keys docid ozoh1ezv8cbamg2ho320viewing your api keys docid ozoh1ezv8cbamg2ho320adding a key group docid ozoh1ezv8cbamg2ho320linking an api key to the api key group docid ozoh1ezv8cbamg2ho320deactivating an api key docid ozoh1ezv8cbamg2ho320deleting an api key docid ozoh1ezv8cbamg2ho320 about api keys you can link user groups to one or more api (application programming interface) keys, which are codes that authenticate access and can be used to track api usage api keys are not tied to user sessions with expiration times when using desktop and server management (dsm) you can use the api key to grant access for a specific user trying to access the dsm application installed on a specific computer you must link an api key to a specific key group to grant user access use key groups to structure api key access for example, you can restrict api key usage to specific users, or to groups of users logging in under a specific role viewing your api keys from the configuration console, click configure > security controls > api keys to open the api keys workspace the application displays the api keys api keys workspace adding a key group from the configuration console, click configure > security controls > api keys to open the api keys workspace the list of api keys appears click add key group a blank key group form appears enter information in the fields name a unique name for this api key group description a brief description of this api key group click save key group the api key group now appears on the list linking an api key to the api key group from the configuration console, click configure > security controls > api keys to open the api keys workspace click add api key the application displays the new api key workspace enter information in the fields field description reference id automatically generated by the application is associated only with this key group activated specifies that this api key has been activated this option is selected by default uncheck this option to disable this group as an active key group if not checked, this key cannot be used until it is activated description a description of the api key on behalf of the employee on whose behalf you are creating the new api key you can restrict the employee to one or more specific addresses choose an employee from the list, then click select in role the role to associate with this employee by default, this user can access the api from any ip address to restrict the employee to one or more specific addresses, click add new ip enter a valid ip address and click ok click save key click back to return to the main manage api keys page deactivating an api key from the configuration console, click configure > security controls > api keys to open the api keys workspace click deactivate next to the key to deactivate the link changes to activate deleting an api key from the configuration console, click configure > security controls > api keys to open the api keys workspace click delete next to the key to delete the key no longer appears