1 00:00:01,566 --> 00:00:07,432 Authentication with the Value Set Authority Center (VSAC) SVS API 2 00:00:07,433 --> 00:00:09,999 The VSAC API allows users and computer 3 00:00:10,000 --> 00:00:12,533 programs to retrieve value set content and 4 00:00:12,533 --> 00:00:16,599 metadata using the IHE Sharing Value Sets XML format. 5 00:00:16,600 --> 00:00:18,800 You will need a UMLS Terminology Services 6 00:00:18,800 --> 00:00:22,733 (UTS) account to use the VSAC SVS API. 7 00:00:22,733 --> 00:00:25,233 You can either hard code API calls into your 8 00:00:25,233 --> 00:00:28,866 computer program, or you can use various API applications. 9 00:00:28,866 --> 00:00:31,732 The VSAC API offers a REST service to obtain 10 00:00:31,733 --> 00:00:34,766 CAS Ticket Granting Tickets, or TGTs, and 11 00:00:34,766 --> 00:00:36,799 Service Tickets, or STs. 12 00:00:36,800 --> 00:00:41,366 In order to make API calls to the VSAC, do the following: 13 00:00:41,366 --> 00:00:43,799 First, obtain a TGT using your UMLS 14 00:00:43,800 --> 00:00:46,400 username and password by making a POST 15 00:00:46,400 --> 00:00:56,333 request to https://vsac.nlm.nih.gov/vsac/ws/Ticket 16 00:00:56,333 --> 00:00:59,999 This TGT is valid for 8 hours and it can be re-used to 17 00:01:00,000 --> 00:01:02,633 make API calls to obtain single-use 18 00:01:02,633 --> 00:01:06,966 Service Tickets that are necessary for each VSAC API call. 19 00:01:06,966 --> 00:01:09,832 Second, obtain a single-use Service Ticket. 20 00:01:09,833 --> 00:01:12,299 Use your TGT to make a POST request to 21 00:01:12,300 --> 00:01:21,433 https://vsac.nlm.nih.gov/vsac/ws/Ticket/. 22 00:01:21,433 --> 00:01:22,999 Specify the URL 23 00:01:23,000 --> 00:01:28,600 http://umlsks.nlm.nih.gov 24 00:01:28,600 --> 00:01:31,466 as the service in the POST request. 25 00:01:31,466 --> 00:01:34,066 Each service ticket is good for 5 minutes but 26 00:01:34,066 --> 00:01:37,132 expires after one call. 27 00:01:37,133 --> 00:01:38,999 This concludes our tutorial. 28 00:01:39,000 --> 00:01:41,800 For additional information on VSAC REST API, 29 00:01:41,800 --> 00:01:45,033 go to the VSAC home page, click on the Help button and then 30 00:01:45,033 --> 00:01:50,033 navigate to the VSAC API section under How to Use VSAC. 31 00:01:50,033 --> 00:01:52,399 You can also send us your questions by clicking on the 32 00:01:52,400 --> 00:01:57,500 Contact VSAC link on the upper right. 33 00:01:57,500 --> 00:02:01,000 Thank you for watching!